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Preface 

• ^' ~~ , 

The PLATO IV domputer-based education system was developed in the 
Computer-based Education Research Laboratory (CERL) of the University of 
Illinois, Urbana. PLATO IV is ^ the result of fifteen years of research 
and development effort led by Donald Bitzer, director of CfiRL. Th*S system^ 
presently links nine hundred' graphical-display terminals to a large computer 
in Urbana. Some of these terminals are located as far away as San Diego, 
Toronto, and Washington, D.C. - Studenjis are tutored individually at terminals 
by interacting with PLATO lesson materials created by teachers. There are 
over tv;o thousand hours of PLATO lessons available at all terminals. These 
lessons span a wide range of subject areas and are used by students in ele- 
jmentary schools, community colleges, military training bases, universities, 
and ^bmrferciAl training programs. Authors of lesson materials are teachers 
Jwho i^e the TUTOR lianguage to toll PLATO how to interact with students on 
,an individual baifis. This book explains the TUTOR language in detail and is 
intended to help authors write quality lesson ma^terials- 

In 1967v^aul Tenczar, then a graduate studbnt in zoology, concluded 
that oxis1:ing pdethods of creating computer-based lesson material on the ear- 
lier PLATO III system were unhecessarily difficult. As a result ^ho originated 
the TUTOR language. There followed a rapid -increase in the number of authors 
and in the number and sophistication of the lessons, they wrote. This 
active author conununity in turn spurred the continual development, and refine- 
ment of .TUTOR by requesting additional needed features. In 1970 CERL began 
implementing the PLATO IV system, which afforded a rare opportunity to take 
stock of the evolution of TUTOR up to that point and make a fresh staort. . 
Many useful simplifications were made, and many important features were 
added. The growth of PLATO IV into a continental network brought together 
an ever-wider spectrum of authors through the rich interpersonal communications 
facilities available on PLATO, ^nd the suggestions and criticisms from these 
authors contributed to the present form of the TUTOR language. Also of 
great importance has been the large number of students who have used PLATO 
J^essons and wjjose experiences have influenced the development of TUTOR to* 
meet their needs. The TUTOR language ^described in this book is, therefoto, 
based on heavy use- testing. 

In the earliest phase Paul Tenczar and Richard Blomme were mainly respon- 
sible for TUTOR development. Since then, many people have been involved, 
some as full-time CERL staff members and some as high-school, undergraduate, 
or graduate students. It is impossible to acknowledge adequately the various 
contributions, and difficult even to list all those who have played a major 
role, but an attempt should be made. Paul Tenczar is head of TUTOR develop- ^ 
ment. Full-time people hav« included David Andersen, Richard Blomme, 
John Carstedt (CDC), Ruth Chabay, Christopher Fugitt, Don Lee, Robert Rader, 
Bruce Sherwood, and Michael Walker ^ 



They have been assisted by^Jamesr^Wr^y , Masako Secrest, and Donald Shirer, 
and by Doug 3rov/n, David Frankel, Steven Freyder, Sherwin Goo'bh, David Kopf, 
Kim Mast, Phil Mast,' Marshall Midden, Louis Steinberg, Larry White, and 

Dayid VJoolley. . * ; ' 

* . ''^ 

All of these- people have been involved mainly with "software", the 
programming of the PLJVTO computer in sudh a way as permit authors and 
students to v;rite and use computer-based lessons. Of ^ equal importance to 
tjife technical success of PLATO are the tERL engineers, scientists, and 
technicians who invented, designed, and imp3«emented the ilnique terminals 
and telecommunications devices ('"hardware") which form the PLATO educational- 
network. Many attractive* feature^ of the TUTOR language a«:e closely related 
to the unusual character is.tics of these devices. CERL personnel who have • 
been heavily involved in hardware development InclUde Donald Bitzer, % 
Jack Stifle, Fred Ebeli^igj Michael Johnsofi, Roger Johnson, Frank Propst, ^ 
Dominic Skaperdas," Gene SlbttovNT, and Paul Tucker. 

The PLATO computer is a Contrpl Data Corporation Cyber computer, whose 
ExtenderidlCore Storage provides the high-^peed sC/apping memory essential to 
the imj^mentation of PLATO and^ TUTOR. ■ \ - '5:3 

' ij tKo latter part of chapter I is adapted from a PLATO III document, 
'ZThfe- TUTQ]^ ^nanual" , by R.A. Avxior and P. Te^czar. 

i» * • 

I thank Elaine Avner for editorial assi?Gtance, Sheila Knisley for 
^jj.^nc], and Stanley Smith for photographic vk>rk. I appreciate the encourage- 
ment| VJilliam Golden gave me to finish the taok. 
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Introduction 
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This book describeo in detail the TUTOR language ^.which is used by 
teacherc to create lesson ma terialo on the PLATO IV c<5:feuter-jDased education 
Gyotem. ' Teachoro use the -TUTOR language to express to/the PLATO computer 
how PLATO should interact with fndivid\J61 students • / Students and teachers 
interact v;ith PLATO through terminals each of which includes a plasma-panel 
display screen and a typewriter keyboard, as shown, Using TUTOR, an author 
of a computer-based lesson can tell PLATO how to display text, line drawings, . 
and animations on the student's screen. The author can ask^^LATO to calculate 
for the student, to offer the student various sequencing options, and to 
analyze* student responses. 

It is hoped that you have already studied the textbook "Introduction to^ 
TUTUR" by J. GhosquierOi C. Davis, and C. Thompson, and the associated PLATO 
lessons. Those materials are designed to teach you not only basic aspects 
of TUTOR but also how to create c^d test your own lessons on the PLATO system. 
The present book, "The TUTOR Language", does not attempt to describe the latter 
aspects, such as how to insert or delete parts of your lesson and how to -try. 
out your nc^w lesson. It does cover all aspectO of, the TUTOR language : that' 
is, v/hat statements to give PLATO but not how to type these statements into 
a .permanent PI^ATO lesson space. From studying this . book you could, in principle; 
write d^.;n on paper a ICiSson oxpresr^ed in the TUTOR language, but when you go 
to a PliATO^ terminal to type in your new lesson, you may not know what buttons ^ ^ 

•to push to%ot started. Also, this book discusses TUTOR in more* detail than 
does "Introdtbction to TUTOR", v/hich makes "The TUTOR Language" less appropriate 
for yp\xr inftial study. 

It i/j also lioprid that as you study this book you will try things out at • 
a PIJVTO t(?rminal'. TUTOR is designed for interactive use, in which an author 
v/rites a sliort setjment of a lesson, tries "it, and- frevisei^ it on the basis of 
the trivil. Normally the s^iguenee write, try, rqylse, and try again takes only 
a fev; minutes at a PLATO "^terminal . 'It is far bettor to create a lesson this 
v;ay than to v/rite out a complete lesson on gaper only to find upon testing 
that the overall structure is inappropr'iate. 

It is also helpful to try the sample lesson fragments discussed in this 
book. It is literally impossible to describe fully in this book how the 
examples v;ould appear on a PLATO terminal. The PLATO ^nedium is far richer 
than the book medium. One striking example is the PLATO facility for making 
animations such as a ear driving aofoss the screen. As another example, you 
must experience it directly to appreciate how easy it is at a PLATO terminal 
to draw a picture on the screen (by moving a cursor and marking points) , then - * 
let PLATO ^ automatically create the corresponding TUTOR language statements 
v;hich would produce that picture. ^f^LATO actually writes a lesson segment for 
you! 
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This book is*written in an informal. style. Sometimes, when the context 
is appropriate, topics are introduced in a 'S'ifferent chapter than would be 
required by strict adhexrence to a formal clasj^if ication- scheme. In these 
Ccises the featuiTo is at least mentioned/ in the other chapter, and the "ind^x 
at the end of the book provides an extensive cross- linkage. The order of 
presentation, emphasis, examples, and counter-examples are all based on ' 
extensive experience with the kinds of questions working authors tend to 
a^k aboute TUTOR. In thd past no detailed document of this kind wap available, 
which led to various kinds of confusion in the minds of many authors. It 
ic hop^ that this book will prevent much confusion ftom getting started, 
by answering many questions before they are asked. . < 

If you are a fairly new TUTOlC author, read this book lightly to got 
acquainted witrh the many features, TUTOR offers. Plan to return to the book 
from time to time ao your* own authoring activities lead you to seek detailed 
information and suggostiono. Your initial' light reading should help^orieilt 
you to finding appropriate sections forf later intensive study. AfCer you 
feel you know TUTOR inside and out,^ read this book carefully one last time, 
looking particularly for links among diverse aspects of the language.- This 
last* reading 'V^ll mean much* more to you^ than the firtJtl 

o ' \ 

If you are already an experienced TUTOR author, read this book carefully 
with two goalp in n)ind: to spot features unused in your past work jDUt of 
ipotential benc-jfit, and to acquire a more detailed understanding of the 
structural aopbcto cr£ the language, with^ particular emphasis on judging. 

The remainder of this introductory chapter contains some interesting 
examploo of existing PLATO leosono, a description of the PLATO keyboard 
including the use of the opocial function keys,' And a review of the most 
basic aspects of TUTOR. . ' ^ ' 

° . \ . ■ 

Sample PLATO lessons 

* • 

On the following pages are givoti several examples of interesting PLATO 
lessons. All were written in the TUTOR language. They have been chosen to 
give you some idea of the broad range of possibilities made possible through 
TUTOR. Eaqh example is illustrated with a photograph of the student's 
screen at a significant ot representative point in the lesson. 

The PLATO terminal's display scireen consists of *a "plabma display panelV 
which contains 512 horizontal wires and 512 vertical wires mounted on two 
flat plates of glass betw^pn. which is neon gas-. Any or all of the quarter- 
million (512x512) injjersections of the horizontal and vertical wires ^can be 
made to glow aj3 a small orange dot. (The word "plasma** is the scientific name 
for an ionized gas? the orange glow is emitted by ionized neon gas.) As can 
be cjeon in the sample photographs, the PLATO terminal can draw lines and 
circles on the plasma paftel as well as display text using various alphabets. 
Both drawings an(i text act;ually are made up of nijany dots. TUTOR has many 
display features fox writing or erasing text, and drawings on the plasma panel. 

% 
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D.ialog in whi/h a qhomistry 
student ^at^eriipts to identify 
an unknown compound by 
asking experimental questions 
(Stanley Smith) 
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^ Game of mathematj^al Qtrategy 
in which two grade-school 
children compete in constructing 
advantageous mathematical 
expresDions from random numbers 
appearing on the spinners. 
(Bonnie Anderson) ^ 
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Tutorial on vectors in which 
the student walks a boy and 
girl around, the stsreon and 
measures their ^vector displace- 
ments. (Bruce Sherwood) 
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Russian sentencff drill. The 
markings under the student's 
translation of the second 
sentejice indicate incorrect 
words and misspellings. 
(Constance Cuiftin) • 



These are actual photograp]ia of the plasma panel. The display 
shows orange text and drawings on a black background, but^the 
pictures are shown here as black *on white for ease of reproducticm. 
The plasma panel size J.s *22 cm. square (8.5 in. square). - 
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Graphical illuctration of the biochemical otepo involved 
in protein oyntheoio.. The Gi:udent introducoo appropriate 
DNA, RNA, etc., into an initially empty coll, then watchea 
the syntheoio proceed. Here, the oynthocio broakci dpvm 
for lack of a crucial part. (Pa>r^ Tenczar) 

I 




Using graphiciJ to teach ' 
Eoperanto without uoing 
EnglioI%. Hero the otaro 
have boen^eircled to 
omphacAze to the cJtudont 
hio miatako iii^ counting. 
(Judit|i Sherwood) 



The PLATO keyboard o 

Every PLA-TOt terminal has a keyboard like the one pictured above. The ^' 
keybo^d has a number of special features whiqh are closely relatfed to certain 
aspects at the TUTOR language, such as the HELP key which lets students 
access optional sections of a lesson ^ written ^n TTJTORi 

The central white keys include letters,, the nuinl3er3 0 through 9 along ' " 
the top Vow, and punctuation rtiarks. Note that the numbers " JZf arid 1 are 
different from ther letters o ,and 1. The ^ero has a slash through it to . 
• distinguiqJa it unmigtakeably from the letter o\ Except for these distinctions 
the \phit^T^ys are the same 'as the keys on a standard tjrpewriter. Capital 
letters are typed by pressing either of the SHIFT keys while -striking a fetter 
key. 'Some key^ different characters, such as the keys in the upper 

row: depressing^ ^HIFT key while striding a "4" produces a "$". 



Eight of the letter, keys (d,e.^.^w, q, a, z, ^x, and c all clustered around 
the s key) have arrows marked on them pointing in the eight compass directions 
Typing "e" with a SHIPT ke:f depressed normally produdes a capital "E"^ oii the 
screen, not a noaftheast arrow.- The directional arrows are shown' because 'these 
keys' are sometimes used to control the' motion of a cuaf-sor ^'br pointer on the 
.screen.'^ In this context th$ studerft presses an unr-shifted "e "J and the lesson 
interprets this a^ a^commfand to move a cursor northeast on the screen, rather 
than a command to display an "6" on the screen. Suc1t| redefinitions of^ what 
'a key should do in a palrticular context provide enojcmous flexibility. Anotjier 
interesting e^^ple is the use of the ^keyboard to. type Russian text in the 
Cyrillic alph^et. j - , * " . 

• • • ..'V ' . ' 
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Spaces (blank characters) ar^ produced by striking the loog "space ^ 
bar" at the JDottom of the keyboard. -Holding down a shift J^ey while" hitting 
the space bar, produces a bapkspace. An example of its use^is in underlining. 
fThe underlined word ""cat", is produced by typing, c, a, t; backspace, backspace/ 
backspace, xinder line, ""underline , underline (xinderline is shift-6, not to be ' ^ 
confused, with the minus sign or dash). Typing T, backspace, H will super-/ 
impose the two letters: H. Backspace is used for superimposing characters , 
whei^as'the ERASE key (just to the right of the letter p) is used to correct 
typing errors. , . ^ . 40 . * . 

A few black* keys at the left of the keyboard are mainly associatjed with 
-mathematical operations: plus, minus (also used' as a dash), timesL^d divide 
(t is. e<juivalefit to the slash /) • ' The <^ is used in TUTOR calculations . to ' 
assign values to vari^les. The TAB key is most often used by authors 
'writing lessons , rather than by students studying lessons. Its function is . 
similar tc^ the tabulate function on standard typewriters: pressing TAB 
once is equivalent to hitting the -space bar as many times as is necessary 
to reach a preset column on the screen. Shift-TAB, called CR for "carMage:^ 
return" in analogy with -a typewriter, moves typing down ohe lifie and to the 
- left margin.'' Shift-plufe produces, a 2 '(which means stimmation in mathematical 
notation) and shift-minus produces a A ►(which means difference in mathematical * * 
notation.) ' ^ - ; 

. The black keys at the right of the keyboard are called "function" keys 
because they carry out various functions rather than- displaying a character 
on the sgre6n. By fair the most important function k6y is NEXT. Tjie cardinal 
rule for studying PLATO lessons is "When in dqubt, press J^JTr."" Pressing 
NEXT causes the next logical thing to happen, such as pi^oceeding on to a \ , 
new display, asking fbr a response to b6^ judged, erasing an entire incorrect 
response, etc ^The secoT^d most important function key is ERASE, which is 
used to correct typing errors. Each press of ERASE erases one"" character 
from the screen. Pressing shift-ERA^E (abbreviated' as ERASE 1 ) erases an 
entire word rather th^n a single character. Note the difference from the* 
backspace (shift-space) which does not erase and is used for superimposing 
characters. ' , ^ - ' 

i « The EDIT key is also used for correcting typing. Suppose you have . ^ 
typed "the quik brown fox" when you notice the^ missing "c" in "quik" . You 
could press ERASE1 twice to erase "fox" and "brown", useERASE^to get rid 
of. the "k", then retype "ck brown fox"% The EDIT Jcey" makes slich retyping 
unnecessary. Instead of hitting ERASe;I , you press EDIT which makes the en- 
tire sentence disappear. Press EDIT again, and the entire first word "the" 
appears. Press EDIT again' and you see "the <^ik" on the screen. Use 

^ ERASE to correct this to "the quick". Now hit EDIT twice to br^ng in th^ 
^ "brown" and' "fox". The f inar resultj is ^the quick brown fox". (This 

" takes longer to describe here in words, but pressing the EDIT key a few times, 
is much easier and. faster than doing all the retyping 1;hat would otherwise 

' be necessary'. The EDIT1 key (shi*f t-EDIT) brings back the entire remaining 

portion of a sentence. For example, -after inserting the "c" to make "the 
' quick", you' could hit El3lTl once to bring back "brown fox". *You should type 
some sentences at a PL?.TO terminal and study the effects produced 'by EDIT 
and EDIT1 
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A closely-related key is COPY. COPY and C0PY1 are used mainly by 
authors. While EDIT- and EDIT1 cycle through words you h^e just typed, 



V COPY and C0PY1 biding iQ words from a pre-defined "copy" sentence 
ke^s are used heavily when* changing or inserting portions of a 1 



These 
esson. 



The display "a^fe" can made by hitting a, then SUPER, then 2, then t 
SUPER makes' a non- locking moyement higher on the screen for typing super- 
scripts. Notice that SUPER is struck ahd released, not held down while 
typing the superscript. Striking shift-SUPER makes a locking movement, * 
.so that the sequence a, shift-SU^ER, 2, b will produce/^^. A, similar key 
is SUB: H2O is made by typing H, SUB, 2,0. A locking subscript results 
from shift-SUB, whidh is also what is used to get down from a locking 
superscript. Similarly, shi^t-SUPER will "move up from a locking subscript. 



There ^re 34 additional characters not shown on the keyboard which are 
accessible with the MICRO key. For example, striking arid releasing the 
MICRO^lg^y followed by hitting "p" produces a ir. The sequence MICRO-a pro-^ 
duces "lin a. Typing e, MICRO, q produces whereas typing E, MICRQ, q 
produces E. Note the "auto-backspacing" which not ^oniy backspaces to " , ^ 
superimpose the accent mark but' also ^Dlaces the accent mark higher on a 
capital letter. Six^MlCRd options involve autobackspacing^: ^(q))l^^(e), . '■ 
" (u) , "(x), "^(n), qind .(c). The last' accent mark (MICRO-c)" is used 'for 
creating cedillas (9 and C>^and does not" involve a different lieight for 
capitals. It 'is easy to remember these keys bec^se of natural associations. / 
The and " accent markg are on the q and e keys which have the ^ .and / 
krrows marked on them. The umlaut " usually appear ot] a u (German Th6 
circumflex '^^ is on the x key. The^ tilde usually appears*on an n (Spanish h) . 



The Greek letters a, 3, 6, 6, X, \i , tt, and av are produced by typing 

MICRO followed by ar, b, d, t, 1, itl, p, r, s, or w. Here is a complete ^list : 



key MICRO-key 



a " a (aipha) 

b e (betk) 

d 6 (delrta) 

t e ('theta) 

1 X nambda) 

m p (niu) 

p ir (pi) • 

r p (rho) 

s - a (sigma) 

w 0) (omega) 

q (grave) 

e " (acute) 

c J (cedilla) 

u " (umlaut) 

n " ( tilde ) 

X (circumflex) 



c5i 



ke^ * 
0 

< (shift-j^)* 
> (shift-1) 
[ (shift-2) 
] (shift-3) 
$ (shift-4) 

5 , 

6 



MICRO-key 



("embed" symbols) 



{ 
} 
# 

9^ 



) 



(shift-=) 

o 
I 

D 

A ^ 

X 

+ 



t 

& 

\ 



(less than or equal) 
(g^reater than or equal) 

(braces) 

'ft 

(pound sign) * 
(each) ^ 
(arrow) 
(not equal) 
(identity) 
(approximate) 
(deigree sign) ^- 
(vertical line) 
(east) * 
(north) 
(west) 
, (south) 
(special) 

(ampersand) 
(backwards slash) 
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These are the standaM MICRO definitions. * You can change these^ hV setting 
up your own micro table. Tliis is discussed in chapter VIII. 

- • •• i 

The standard charac^r set j^ncludes all the characters we have seen so 
far, including the Greek letters and ot:her * characters accessible through the 
MICRO key. The shifted MICRO key., called FONT, lets you shift from this 
standard set* of characters to another set of up to 126 special characters 
which^you can design. These special characters might ba the Cyrillic^ 
Arabic, or Hebrew^ Iphabet, or they cafti be pieces of pictures, such as the 
characters ^ ^ ^ , and ^ whigh form a car when displayed side by 
side: f'^^ . Unlike MICRO which only affects the next keypress, FONT 
lacks you in the alternate -"font" pr character-set. You press FONT again, 
tp return to the standard^ font. The* creation of new character se.ts is 
described in chapter VIII. ' , 

-If the author activates it, the ANS key can. be used by the student to 
get the cortect answer to a question. This is discussed in chapter VII. 
The shifted ANS key, TERM, when pressed causes the question "what term?M. to 
appear at the bp(Jj?tom of the screen. At this ppint you can type any of 
various ke^ords *to, moyp ^to a different vpa.rt :^:^£,v^he lesson. The use of 
^ERM' is discussed in chapter V. ^ ^ ^'^^^^ ' 

If you seJt up an optional help feequence^x^ thei,.^ student can press the 
HELP key to enter this sequence. He can press BAC^ (or BACK1 ) to go ba&k 
to where he was when he requested help, or he viM^ be brought back to the 
original point upon completion of the help secjuence* You could also specify 
a different help sequence accessible by pressrng HELP! (shift-HELP) . The 
six keypresses HELP, HELP1 , LAB, LABI, DATA, and DATA1 can, if activated by 
the author, allow the student a choice of six different help sequences. 
You c^n also activate NEXT, N^IXTI BACK and BACKl , but these simply let 
the student move around in the lesson without remembering and returning to 
the original place. In*^other words, these four keys do not initiate "help" 
sequences. Usually BACK is reserved for review sequences or similar situations 
where you wax^t^o back up. 

•" . • * 

The STOP key throws away output destined for the terminal. A useful 
example is the case of skimming through pages of text in an on-line catalog 
or collection of noteS. If you decide you want to skip immediately to the 
next page, you might press STOP so as not to wait the several seconds 
required to finish plotting the present page. ■ 

The ST0P1 or shift-STOP key plays a crucial role. You press ST0P1 to 
leave a lesson you are studying. When a student is ready to leave the ter- 
m^tial he presses ST0P1 , which performs a "sign-out" function.. Among other 
things, the sign-out procedure brings his p^lmanent status record up to date 
so that days later he can sign-in and restime in the same lesson where he left 
off. .When an author presses ST0P1 to leave hi*s lesson -that he is testing, 
he is taken back to, a point in the PLATO system where he can make changes in 
his lesson before trying it again. 

The key next to HELP with the square (□) on it does not yet haye*a 
specific function. The shifted square key is presently u^ed as the-^ACCESS 
key, as described in chapter VIII. \ 
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Basic agpects of TUTOR * 

T 

In- their simplest form, lessons administei^ed by the PLATQ interactive 
educational system consist of a repeating sequence : a display on the 
student's screen followed by the student's response to this* display. The 
display information may consist of sentences, line drawings, graphs, animations 
(moving displays) - 4aearly anything of a pictorial nature - and in any com- 
bination. The student responds to this display by pressing a single key 
(e.g., the HELP or NEXT key) or by typing a wbrdl sentence, or mathematical 
expression, or even by making a geometrical construction. Lesson authors 
provide enough details about the possible student! responses so that PLATO » 
can maintain a dialcig with student. The sequencd of a display followed 
by a response* is the basic building block of a le^sson and is called a "unit" 
in the TUTOR language. This "display-response" terminology is convenient 
but is riot intended to imply ^that the student is in a sub^rvient position. 
Often what we will conventionally call the stud^At "response" is a question' 
or a command to PLATO to Respond with a display j^f some kind. 



An author constructs a lesson by writing lOrie "unit" at a time. For 
each unit, the author uses" the TUTOR slanguage ta^ specify (1) the display, 
that will appear or^ the student's screen, (2) hdw PLATO is^to handle 
student responses to this display, and (3) how tjhe current unit connects to 
other *units. 

A statement written; in the TUTOR language aj^Dpe^rs as follows: 
How are you today? 
tag 




The/ first part of the st^ement (-write-) is call! 
remai^nder (Hfiw are you today?) is called the ^ag 
represent PLATO functions. Following is an entir 

The figure shows what "^a student would see 'on his .screen while working on the 
unit. 



d the command y while the 
/command names mnemonically 
unit written in TUTOR. 



unit 


geometry 


at 


1812 : 


write 


What is this figure? 


draw 


51^f;15rj3;154i?;51J2f 


currow 


2JJ15 


answer 


„<it,is,a^ (right, rt) triangle 


write 


Exactly :tight! 


wrong 


<it,is,a>. square 


write 


Count the: sides I 




As one can infer, tags individualize commtinds for the particular function 
desired. We will discuss eacb statement of tfvis unit in detail. 



/ 
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' unit, geometry. 



The -unit- statement initiates each unit. The tag (geometry) will 
become useful later when ^ units are connected together tp form a lesson,. 
Each \&iit must have a naipie. ^No two units irf a. lesson *]|aay have the same 
name, * 



at 



1812 



The •-at- statement specifies at what^sition on the screen a display 
will occur. The tag "1812" means that we will display something on the 
18th line in the 1 2th ^character position. The top line of the screen 
is line 1 and the bottom line is line 32. ^ere are 64 character . positions 
'going frdm 0^ at the left- edge of the screen^^^p^ 64^ at the right, 'Thus, 
1J?1 refers to line 1, character position jil 0sMk',^pper left corner of the 
screen), while 3264 refers to line 32, character position 64 (the lower 
right corner of thfe screen). Note that means th§ number zero, as 
distinct from the letter "O", 




write What is this figure? 



The -write- statement causes the text contained in the tag to be • ^ 
dioplayed on the Qtudont'c Bcrecn, The writing starto at line 18, character 
pooition 12, ao opocified by the preceding -at- statement, ■ 



draw 



51ja;151ja;154ja;51ja 



The -draw- statement specifies a straight-line figure to bo displayed 
on the screen, Iij^ this particular case a Geries of straight lines will be 
drawn starting at location 51 J3 (lino 5/ character Jpos it ion Tj3) , going ver- 
tically downward to location 151J3, then to the right to location 1540, and 
finally ba^ck to the starting point, 51 J3, This producea .a asiight triangle on 
the atudent'o screen. 
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Th 
display 



arrow 2)315 . ; 

5 -arrow- statement acts as a -boundary- line that separates preceding 
. . statemei^ts from following response-handling statements. Thus, what 
preceded the -ai^row- command produces the screen display which 'remains visible 
while tihe student works on the question. ^-Statements ^fter the -arrow- command 
are usdd in handling student responses to the display. In addition, the 
-arrowi statement notifies TUTOR that a student response is required at this 
point in the lesson. The tag of the -arrow- statement locates.the student 
response on the screen. An arrowhead is shown on the screen at this place ^ 
to indicate td the student that a Response is desired and to tell hirti where 
the -response will appear'. In this case the arrowhead will appear on line 
20, character position 15. The student's typing will start at 2)317, leaving 
a space between the arrowhead and his first letter. 

: ^ N 

, answer <it',is,a> (right, rt) triangle 



I wrong <it,is,a> square ^ ^ 

^ The -answer- and -wrong- statements are used to evaluate the student's 

response- The sjDecial brackets <^and •> enclose optional words, w>ile the 
parenthe^e|/ enclose important words which are to be considered synonyms. 
. Thus any of the following student responses would match the -answer- etate- 
\ ment: "a right triangle", "it is a rt triangle", "rt triangle" , etc. 

^ • ■ I ' ' ' 

* ' ' the response matches the tag of tl^q -answer- statement, TUTOR writes 

"ok" after the student's response. For a match^ to a -wrong- statement,' "no" 

is writ-ten. An, "ok" judgment allows the student^ to proceed to the next 

unit, whereas a "no" judgment requires t))e student to erase and try again. 

Any response not foreseen by -answer- or- -wrong- statements is judged "no". 

Ffaving matched the student's response, TUTOR proceeds to execute any 
display stat^iftpnts following the matche^ -answer- or -wrong- statement. 
Thus, student xresponseq of "a" right triangle" and "square" will trigger 
J appropriate replies. In the absence of specific -at- statcmento, TUTOR 
will display theoc replies three lines belowthe student 'o reoponoe on the 
screen. Here ia what happens if the student responds with ."a loVely trinqlo, 
right?": . ^ a ^ , 

TUTOR automatically marks up the student's response to givd detailed infor- 
mation on what is wrong with the response. The word "lovely" does not 
belong here and is marked with XXXXXX, the word Z'tringle" is misspelled 
and is underlined, and the word "right" is out of order, as is indicated 
by the sfnall arrow. , ^ s. 
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* statements can be added to the current example unit which will greatly 
improve it. Consider the following: ' 

unit geometry ^ * 

at 1812 

1 write * What is this figure? • % 

draw 51^;151^;154fl;51^ ^ 

arrow 2015 

^--^n> specs' bumpshift^ ^ 

answer <it, is, a> ' (right ,rt) triangle \ 

write Exactly r^ghtl \ 

answer <it,is,a> (three, 3) sided (right, rt^) polygon 

write Yes, or a right triangle, 

wrong <it , is , a> triangle 

at 1 605 

write Please be more specific. 

It has a special angle.* 

draw 1410;1412;.15'12 

wrong <it,is,a> square 

write Count the sides! 

As you can soe, any number of ^anst/er- and -wrong- statements can be added 
to. the response-handling section of the unit. Time and effort spent by an 
author in providing for student responses other than the- common answer can 
greatly increase the ability to carry on a personal dialog with each student. 
The figure shows what the student will see if he responds with "a triangle". 




The -specs- stat^ent is intJt^'oduced here. It is used to give optional 
specifications on how the student's response is to be handled^ In ^his 
case the tag, '^'bumpshif t" , specifies that any capitalization in the $tu'dent's 
response is to bo thrown away.' As far as the fqJ.lowing -answer- and Vwrong- 
commands are concerned, it is as though all the student's capital letters 
were replaced by lower-case letters. iThe student's response displayed on 
the screen is not changed.) Without this specification, TUTOR would consider 
"Right Triangle" to be misspelled There are many convenient options avail- 
able in a -specs- statement. For example, "specs okextra,noorder'- specifies 
that oxtra words not mentioned explicitly in following -^answer- and -wrong*^ 
utatomento are all right, and that the student's word order need not be 
tho some* as the word order of the -answerv- and -wrong- statements to achieve 
a match. Such options can be used to broaden greatly the range of responses 
which can bo handled properly. " ^ 

Lessons could be written usin^/only the commands already discussed. 
ExplT^natory units could be^ written using only display commands. Tutorial 
units could be interspersed to t6pt a student's understanding of the lesson^ 
material. Thus a single linear chain of units could form a lesson. However, 
mastery of a f ov; more TUTOR commands opens up a wealth of "branching" or 
sofjuencing possibilities] Branchjlr^g, the technique of aiJLowing alternate 
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paths through a lesson, is 
student. The example unit 
-nextnow-i -back-, and -help' 



1-11 

[ 
w 

ie of the keys to personal dialog with each 
.1, therefore, be expanded to Include -next-, 
i commands: 



I54t 



figure? 
i5ljj 



\unit geometry 

fnext moregeom ' 
help thelpl 
back intro 
1812 ' 

VJhat is this 
51jJ;151)3;11 
20} S 

bumpshift 

<it,is,a> (rilg*ht,rt) triangl^ 
rfxactly^ rightlll ^ 
<it , is , a> trip^gle 
16jJ5 . 

Please be mor(^ specific- 
It has a special angle. 
141jJ?1412;1512 
<it,is,a> square 



at 

write 
draw 
arrow 
specs 
answer 
write 
wrong 
at 

write 

draw 
wrong 

nextnow treview 



Thdj tag of the -next- statement following the -unit- command gives the name 
of the next 'unit the student will see upon the successful completion of 
unit "geometry"" The -next- statement is neces^^ajry because in a highly- 
branching lesson sequoQce the next unit, for a student may not be the unit 
following in the lesson. , For example, a diagram of the lossort flow involving 
unit "geometry" might be: 



Partii^l' Diagram of Lesson 



unit treviow 



NEXTNOW 

Basic ^sson 



NEXT 



unit 




intro ^ 
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BACK 



unit geometry 



unit 


thelpl 




f 


unit 


thelp2 


i 


unit 


thelp3 




unit 


moregeom 



HELP 



Optional Branches 



end 



^1 



In moving from one unit to another the screen no^ally .Is automatically 
erased to make room for the displays produced by thp following unit. 

The -help- statement refers to a help unit which the student may r,each 
through use df the HELP key. Help units are constructed in the same manner 
as unit "geometry". However; "fehe last (or only) unit in a' help sequence^ 
is termifiated by an -end'- command* Upolfi completing the last help unit, the 
student is returned to the' "base]** unit,( the unit from which he branched (in 
this case unit "geometry"^. The studerlt need not complete the eptire help 

He maV press BACK or s^ift-BACK to return to the *baBe unit from . 

<i^lp Units for unit "geometry** dbuld' appear 



sequence 

any point in the help sequence 
as follows: 




* These units are help'JU^iits for **geometry". 



"unit 

at 

write 
draw 



unit 
at 

write 
draw 



the lb 1 

The tigure has thjree sides. 
51iJ;|51iJ;154jJ;51^^ 

I ■ ■ 

thGlp2 ' - , 

1828 • ; , • 

It a).cjo hao <:hrea anglbs. 
510;15V;154^»;510 



unit 
at 

write 

draw 

end. 



thelp3 
1828 

Note the right angle. 
510;1510;1540;510 



Any statement which h6gins with an ao1;erisk (*) has no Offect on the operation 
of the le^Gson and may be used anywhere to insert comments to describe the 
units. A comment ot^tomdnt between units improves readcjibility by guiding the 
eye to the unit subdivisions of tho lesson. 

, Tho -back- statement permits tho student to move to a different unit 
by pressing the BACK key. Because of its name, it is c^fitomary to associate 
^a review sequence with the BACK key. If a student is i^n a non-help ur^it 
that does not corfcain a -back- statement, the BACK key does nothing. In a' 
help-sequence unit t^hat has no -back- statement, the BACK key returns the 
student to the original base unit. 
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If the student calls the figxire "a square", he will see this response 
judged "no" and gets^ the reply "Count the sides 1" The -nextnow- statement 
is used to force student through additional material. It locks the key- 
^ard so that only the NEXT key has any effect. In particular, the student^ 
cannot erase his response. When he presses NEXT, he will be sent to unit 
"treview". Upon completion of one or jCnore units* of review about triangles, 
the author might return the student to unit "geometry". Thus, this student's 
lesson flow might • consist of : 

1) ^ a discussion of geometric figures;^ • , ^ 

2) a question about a right triangle; ^ ' 

3) an error causing -nextnow- to lock the keyboard; 

4) further study of triangles; ^ 

5) finally, a return to the right triangle. ^ 

Considbr now the problem of using unit "geometry" for a second student 
response. Additional ..display information is needed to ask the student a 
second question and another -arrow- command is needed plus a second set of 
response-handling statements. The unit could appear as follows: 

geometry 
moregeom 

intro " i 
tholpl 

1812 ^ 
What is this figurj'^ ' ^ 

510; 1510; 1540; 510 . * 
2015 j 

RGsponse-hemdling (statements ^ f 

for first arrow. ' ' . ^ ^ 

' i 

^''"'^ onda^r^ow 

^ at 2512 ' I 

write How many degrees in » . . jt 

a right angle? ^ \ \ ^ 

hqlp angles ' ' 

arrow 2815 . ' 

Roaponde- handling statGrnqnto 

for GGcond arrow . « 

^-^ . ' . 

The -ondarrow- cbmmand delimits the responsG-han^iling otatemGnts associated 
with tho first -arrow-. Only whGn thG first -arrow- is oatiofiGd by an "ok" 
judgmGnt will TUTOR procGGd past thG -Gndarrow- command to prosGnt the* oGcond 
<jUGation. ThG otatGm^Gnt "hGlp angles" ovGrridGo thG earlier statemGnt; 
"hGlp thGlpI".. If thG GtudGnt prGoaea thG HELP key whilG working on the 
oecond -^-arrow- hG will rGach unit "angles" rather than unit "thelpl". 




The second que stdon 'could have been given ^in a separate unit 'rather 
than following an -endarrow- command. The major difference is tljat the 
entire screen is nprmally erased in proceeding .to a new unit, whereas here 
thp' second question was merely added to th^ existir^g screen display. 
Even if there is'" only one -arrow- command in a unit, -endarrow-^ can be 
useful, for it c^ be followed by display or other statements to be per- 
formed only after the. -arrow- is satisfied. ^Thia is particularly convenient^ 
if there are several -answer-* commands corresponding to several dij^forent 
classes of acceptable responses. , . ' 

' Fourteen TUTOR commands have been illustrated in this chapter. This 
repertoire is adequate to begin lesson Siting; and if you have access to 
-a PLATO terminal, it would b^ useful at this point ta try out the ideas 
discussed so far. - V 



r 




II. Wore on Creatii^g Displays 



' Particular attention should be paid to the question of how to dispJ^ 
text and line >iraw±ngs to the student. Good or .poor displays of material 
in a lesSOn can make thc^ difference between a Successful or unsuccessful'^ 
lesson* Imaginative use of ^raphics^, including animations (inoving' disp.lays) ,^ 
will capture the attention of the student and transmit your 'message to him 
much more efficiently than would mere text. You haVe already ^pSt ^oy' 
write "text and ciraw figures by using the 7at-, -Write-, and -xjJE^ 
This chapter will, discuss how to achieve finer control over slMMp position^, 
hofr to draw circles and circular arcs^ how to difepl^y large- jii^text and 
write at an angle, and how to e^rase portions of the screen. The ability to 
erase a portion of the screen makes it possible to create aiwnat^^d displays. 



Coarse grid and fine grid ' . 

It is convenient to specify a line number and character position 'for 
displaying text. We have seen tha't the TUTOR statement '^at 1812" 
instructs PLATO to display information starting on the 18th line at the 
-12 character, position. Line 1 is at ^he top of th^ screen and 'lini? 32 is at" 
nthe bottom. Each line his room for 64 characters, with character position 
0^ at the left and character position 64, at the right. This numbering scheme' 
is ^called the coarse grid or gross grid. 

Sometimes it iS necessary to position text or draw a figure with finer 
control than is permitted by the coarse grid. The PLATO screen consists of 
a grid of 512 by. 512 dots', and the, position of any of these quarter-million 
dots aan be specified by giving two numbers - the number of dots from the left 
edge of the screen (often called "x") and the number of dots^^up from the bottom 
of the screen (o^ten called "y"): 
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The poaition ohown would be referred to ao "384,128" in a-n -at- or -draw- 
otatomont. Thio position in equivalent to the coaroe grid location 2449 . 
(line 24, character pooition 49). Ao an example. 



unit , double 

(It ' 384,128 ^ • , 

write 'double WRITING " • . . 

at 385,129 : ^ . ' - 

. write DOUBLE WRITING ^ * ' ^ * 

would write "DCftJBLE WRITING" twice ^ displaced horizontally and 'vertically^ 
by bnc dot. Thifi looks like this: ' * ^ - 

.tE;! (jlji^irTI'jl'NiCi^ enlarged.) 
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'The -draw- command permits mixing the two numbering schemes 
. draw • 1215;1225;12jJ,24jJ;1855 



This meana "draw a straight line from^ 1215 to 1225, di^aw a second st;raight ' 
line froift there to (12jJ,24jJ), then draw ix third straight Jine from there to 
1855*^. Note that eac^ j^oint, whether exp;resQed In coarse grid or fine grid, 
must be set off by a semicolon. 



-circle- command 



In addition to displaying text and line drawings, it is possible to 
draw circleo, ^arto of circles, and broken or dashed circles. A pircio whose 
radius is 1^5 doto , centered at x«2^jJ, ya30jj,' Lq specifiedlby 

* . circle 1:^2^0,3^ " . ' 

^ center (x ar>d y) - , ► ^ 
radius . .. * , /* 



.Is . 



If the command .n«'amo is ehtingd!. to -circlob-'a broken -or dashed circle will 
be drawn. A-partial circle is opoeifibd by givlrig a otajrting and ending 
angle: * 



en:dirig angle ^ 
t^t«» 1 11^ Angle ^ 



/ 



b for br5>k«n 
or da^'hcd 
circle 
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Large- size writing: .-size- and -rotate- • * 

It is possible to have text^displaye'd in larger than noimal size, 
and even write at an ang'le. This is particularly useful in sho>?irig an eye- 
catcl^ing tit^;Le on a page. Here is a sample display with the corresponding 
TUTOR statements. The "$$" peinmits a comment -^o appear after a t^g. 



$^text 9.5 tames normdl size 
$$ text rotates 45 deg3?ees 

$$ return to normal writing 



For technical reasons the large-size writing comes on the screen much jnore 
slowly than does normal texl^, but the speed is adequate for' short titres. 
Us^"size 0^ to return to noirmal vpriting. Normal ^writing is unaffected by 




unit ^ 


title 


size 


9.5 


rotate 


45 




2519 


write 


Latin 


size 




rotate 




at 


3125 


write 


Lesson 



.-rotate-: use- "size 1" if it is desired to rotate text of the Standard o 
size. Size 1 writing appears at the same slow spded as larger writing (about 
6 chajfkcter per second, or 6JJ words per minute)^.* Only size JJ writing is rapid 
'(18JJ characters i5er second, or 1 8JJJJ words iDejp minutjs) • 

' . > 
BE SURE TO RETURN -TO SIZE 0!! Ij^ you forget tp place a "size ^f" 
statement after the' completion of the j special writing, all: of your text will 
^be written slowly <and pros^sibly rotated). It is also good practice to say 
"rotate J3", so that the next^ time yoii use "size" the ^rotation will, fee through^ 
JJ degrees unless st'ated otherwise. \ \ 

Animations (moving displays): -erase- and -pause- 

' An animated display can be created by repetitively displaying somei^ text, «. 
pausing, erasing the text and rewriting it in a new position on the screen. 
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Hez^^s a unit ^which will show, two balloons floating upwards: 



unit 
at 

write 
. ^t ' 
"^rite 
^..^^--ji? pause* 
at 

erase 
at , 
write 
pause. 

a,t 

erase 
at 

write 
. pause 



balloons 

3020 • ^ 

Watch the balloons go up.l 

/ . 

$$ use 00 for ijalloons 
$$ suspend processing for 1.5 seconds 



250, ^00 
00 

1.5 \- 
250, ^ 00 
2 

250, ^50 

00 

1.5 

250,15iJ 
2 

250,200 

00 

1.5 



$$ erase two characters • 

$$ reposition 5J2f dots higher 







The statement "erase' 2" selecta?lrely erases two character positions without 
disturbing the rest of the screen. In ^part^-cular , ^ the text "Watch the'-baH'oons 
go upl" wilJL stay on the screen. ' 



There are other forms of "the -erase- commatid. The statemenip 
."erase 12,3" will selectively era^e a block of 12 character positions on 
three consecutive coarse-grid lines. The statement J'jQ^^se" with, no tag will 
erase the entire screen instatntaneously: , the* same full-^screen' erase normally 
takes place automatically upon moving to a rjjew main ui^iit. 



-pause-, -time-, -and -catchup- 



The -pause- statement with a tag in seconds suspends processing for the 
"specified amount of time. If the tag is omitted, TUTOR waits for the student 
"to strike a key> any key, rather than wait a specified amount of time. , This 
form is particularly suitable in more compiLicated situations wh^re the student 
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x^ay 'want 



unit 
at 



write 

4. 



pause 
at 

write 



pause 
at 

write 



udy each step before proceeding, ffere is an exampl 



4^ 



discuss 

There are several kinds 
of -erase- commands 
for "seleotive and/ full 
"erasing of the screen, 

152J3^ 

"erase 5" will era^ / 
5 spaces, "erase 25,4* 
will erase 25 spaces 
on 4 lines. 

252J3 ^ / 
An -erase- cfpmmapd | 
with a blank tag 
will erase the whol6 
screen. 



s 




I 



Each* time the student pr^^es a key .to move past the -pause- command, 
more text is added to the^Blreen. This prevents the student frolflfi feeling- 
overwhelmed ty too much text being -thrown at him all at once. Each new 
paragraph is add/fed only when, he signals by pressing- a" key that he wants to 
go on. On the other hand, this structure leaves the^ earlier paragraphs on 
the'^screen so that he can look back to review. If* the -patis6-* commands were 
replaced by -unit- cohunands, each paragraph would reside in a separate main 
unit. » When the student presses NEXT to^move on to the nexf^main unit, the 
screen is completely erased to make room for the next display. /This would 
accomplish the objective of letting the student control the raife of presen- 
tation of new material but would not leave the earlier paragraphs on the 
screen for review, and comparison. * , i, 
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iC is' irvadvisalile in thi^s applica'tion to use "pause 1-5" rather tha^i 
"pause" I f or 'th^a the student has no control over the presentation rate. 
Any tiine delay you choose will be too fast for some studentis and too slow 
for others I A ti^ed -pause- is mainly useful for animations* Sometimes it 
is appropriate to move on after a long time if the student hasn't pressed a 
key himself. This can be achieved with a -time- command: . ^ 



pause 



The "time 3J3" statement Will "press the timeup key" after 3)3 seconds^ so 
that if the student does tiot press a key, TUTOR will. 'But the student can 
moveyon sqoner by pressing a key before then, which is not possible if^you 
use "pause 3j3". 

To summarize, there axe three types of -pause- situations: 

1) pause '^n » pause n* seconds whether 

keys are pressed or not ' 

2) , pause wait for any key *■ 

3) ' time n • wait for aifffiPkey or n seconds. 

pause " , 

^ Occasionally ^yoM might want to send several seconds /worth of output 
to the student's screen, then pause two^secondg, then ad<^ something else. 
If ybu write ^ ^ w ' 

I ■ ■ ■ / 

\ several seconds, of display text and 

urawings which take several Seconds to ^ .» 

<c:^^nt on the screen 

-followed by- 

' \ 

pause ^ ' , ' 

. write More text. ... ' . 

it V 

you will, not get the desired effect because TUTOR will add "More *^t ext. .. " 
right aftbr the initial material headed towcord the terminal,, since the 
"pause 2" end^ before thfe initial display is finished. The student /will 



/ 
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see no gap betweep the first and Isecond parts of the display. The problem 
is solved with k -catclnup- command: • 



catchup r . 

pause 2 • 
write More text. • . • 

The ^-catchup- commanli tells TUTOR to let the terminal "catch^up" on its \ 
work up to that point before continuing. Then you pause an additional two ] 
seconds^ arjd you get the desired effect'. o- 

The -mode- command . - 

The -erase- command may be used to erase blocks of character positions 
or the whole screen. Something else is needed for selectively erasing line 
drawings created with -draw- and -circle- statements. The PLATO terminal 
can be placed in an erasure mode in which the terininal interpjfets all* display 
instructions as requests to erase rather than to light up thd corresponding 
screen dots, this is done with the -mode- coiranand: 



unit 


modes 




at 


3517 


r 


write 


Selective erase of ac figure 


draw 


121JZfj2JZf1j3;2j35j3;121j3 $$ 


triangle 


pause 




wait for a^ key 


mode^ 


i erase 


f 


draw 


121j3;2j31j3;2j35j3 $$ 


part of the t^riangle 


mode 


write 




at 


51JJ 




write 


One line left^ 





/ 




On. lifM l€ft. 



G«l«ctiv« crttM of • figure ^ 
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The "write" mode is the normal display mode. Bevsure *to specify 

"mode write" when you are through with "mode erase", or all further 

writing in that unit will be invisible! 



In the standard mode^ ("write") it is possible to superimpose or 
overstrike text with another -write- statement. If, however, a 
"mode rewrite" statement is executed the second -write- statement 
will eras'e the previous text as it writes the new text, and ttiere will be 
no superposition. Compare these sequ<vices in write and rewrite modes: 



mod^ 
at 

write 
at 

write 



write 

1215 

ABC 

1215 

abc 

write inode 



mode rewrite 
at 1215 
write ABC 
at 1215 • 

write . abc 



rewrite mode 



{ superimposed ) 



abc 1. 
^not superimposed) 



In the rewrite case the second -write- statement wipes out the 3-character 
area as it writes the new information. Each charaister area is 8 dots wide by 
16 dots higrf. This determines the number of rows afld columns in cqarse 
grid: (512/8)=64 characters fit across the screen, and (512/16)=32 lines 
of characters fill the screen vertically. 



The statement "erase 



2" is actually^ egjiivajlent to 



mode rewrite 
write (two spaces) 
mode (f^revious mode) 



Writing spaces (blank characters) in rewrite ittode wipes out an entire" character 
area. ^ 

The balloon animation could have been written 



i 


at 


25f5,}f5f5 




write 


00 




pause 


• 1.5 




mode 


erase 




K ^t 


250,100 




write 


00 




mode 


write 



$,$.» instead of "erase 
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This form would be different from the^ form using "erase 2" if thie^^ -were 
other screen dots lit in this area, "erase 2" completely erases t^Wd 
character positions while "write 00" in the eras^ mode erases only* tlie 
dots tnat* make up the letters "00" withou^disturbing neighboring dots^ 

, • . . . ' . - , : 

Automated djsjp^ay^g generation . ' it, 

^ ' \ / 

It should be mentioned that dti aOthor working at a PLATO terminal catf^ 

use a moying cursor to design a display involving text, line figures, circles 
and arcs. The PLATO system then automatically creates corresponding TUTOR* 
statements which would produce that display. The author can alter these 
statements, convert them back into a display, and add to or^lter the result- 
ing display. This facility makes it 'unnecessary in most ca6es*1^o worry 
about, the details of screen positions. - Here is an example of such operations: 
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Move the cursor {the "+") ' 
to draw the road emd to ^ 
mark the eiids of the tree 
trunk. 




Draw the tree trunk. 



\ 




Specify a circle for the 
top of tile tree. Draw the 
house, piace text of var- 
ioii's kiiiidid on the screen, 
^»(The car^ses special 
characters. ) 



draw 

oirol« 

draw 

•t ' 

writ« 

It 

writ« 
■iz« 
rotate 
at 

writ« 



display 

11121 ll82takipf 11441 iHl 
U,344.2II 

11371 U37| tS35| lft33t 1133 
114,225^ Y 



dtaplaymakingt 




PLATO* automatically 
generates TUTOR state-* 
ments corresponding to 
the desired display 1 
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Recall the display and 
% add a flag to the house. 













* - . . 


^ unit 


<ft»pla/ 


<lr»» • 


Itl2| It93;»ktp] |t44| 


Circl« 


l*.944,2tt 


<iraw 


lt97| l*97| 1S99| 1*99) tt99 ' 


at 


114.229 


writ* 




' at 


;t2i 


writ* 


f\ito«»t«d dikplayokakinc* 


«t*« 


9 


rotat* 


•91 


•t 


2S2I 


MTtt* 


Lock' 




I99S| 1 9991 19991 2U,3«*| 377, 2n 




ti 


1 


• ■:. 



PliATO appends a -draw- 
statement corresponding 
to the flag. 




Final resultA The illustrations in this book were created 
by, these techmjiques . The.s'creen displays were phqtographed . 
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III. Building your own tools; -, the -do- conmiand 

; You now know enough about presenting material to the student "to be able 
to make handsome displays. You will be tlble to do even more when you learn 
how to tell PLATO to calculate complicated displays for you. Before discuss- 
ing how to do calculations wo will pause to introduce an extremely important 
concept, the •'subroutine", which is fundamental to all -aspects of authoring. 
We will apply the concept of a sxibroutine right uway to certain display 
problems. 

^o introduce the use of subroutines, consider the problem of placing 
some standard -message on several of your main lesson pages. ForeJCiimple , 
irf the many units where. you make help available to *t:he 'studenC-Tif ^he presses 
the HELP key) you might like to advertise this fact by placing at the bottom 
of the page this display: 



[HELP is available 



The corresponding TUTOR statements might b^ 

. at 3123 " 

write HELP is| availabj.e 
draw 3022} 3J341 ; 3 1 41 ; 31 22; 3J322 

It would be tedious to copy the6e statements into every unit where they were 
required.'' Moreover, if you decided later to move this to the ugper ri^ht 
corner of the screen,' you would have to find all occurrences" of this and 
^jhange all of them. There- is a way^ound these difficulties, and in later 
work we will find further important advantages to the method. Suppose we 
write a "subroutine", a unit to be used many times as needed: 

unit helper « 

at 3123 ^ . . 

write ^HELP is available • 

draw 3iZf22;3JJ41;3141;3122;3jzr22. 

Where we need to show this message we need»only vrite- the statement 

do helper * * • V * 

which attaches unit "helper" tcuthe present unit.' If is as~ though we had 
inserted the contents of unif ^Tielper" at the point where we Say "do - helper" 
Now, instead of a dozen copies of 'the display statements we hav^».9nly, one, 
plus a dozen -do- cpiran^ndsl Th^ -do- command may appear anywhere in a un^-t: ^ 
where you put it will'' determine when the associated display appeairs on tjie 
screen in relation to your existing display material. All these displays 
may be changed by simply changing the subroutine unit I ^ It is hot necfissa'fy^ 
to change the -do- statements; just change unit "helper" wtjich they all use. 
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The use of -do- improves the readability of a TUTOR lesson, .When youo ^ 
see "do helper" anywhere in your lesson you recognize at a glance what it 
is for, wher'^as the contents of unit "helper" might contain a large numbier 
of statements which vould clutter up your other units and decrease readability 
if « these statements appeared ^dii/ectly in each unit. 

/ ' ' ^ 

L<?t*s consider another use. Suppose we wish to draw a "Cheshire cat" 
which fades to a smile as Alice watches.. We want to draw a cat^ f ace made 
up of the smile plus all thq i^st the face, then erase everything i)ut 
the smile. Here is an' elegant way to do it: 



unit 


Alice ^ 


at 


512 


write 
do 


Wat/zfh the Cheshire cati 
cat 


catchup 


^ $$ wait for cat 


pause 


4 . $$ then pause l 4 


mode 


erase 


do 


face f 


mode 


write 


at 


3j312 


write 


See the smile? 



to be drawn 
seconds 




we will need 



some units to^sc 



as the subroutines: 



unit 

do 

do 

* • 

•unit 

circle 

circle 

circle 

unit 
circle 



cat 

face 

smile 

face f 
12j3,25j3,25j3, 
'3j3,2j3j?,28j3 
30,3j3jfl,28j3 



$$ outline 
$$ eye 
$$ eye 



smile 

8J^,25i^,25£f,225,315 




$$ smile - arc goes from 
225'' to 315"* 



Note that unit| "Alice" does unit "cat", which in turn does units "face" and 
"smile". TUTcik permits you to go ten levels deep in -do-s. Here we have 
„go^e only two levelD deep.* Note that unit "smile" on its own is a useful sub- 
^ i^outine? and might be^done whenever just the smile is desired. 

To sxammarize, we can build useful tools -^Dy constructing "subroutines" — 
units which may be done from ma'ny J^laces in the lesson. The liberal use. of . 
-do- improves readability, reduces typing, and facilitates revising the lesson. 
This last point is particularly important when there is a "bug" (unknown error) 
in the lesson. Debugging becomes vastly simpler because of the modular na^ture 
of subroutines and the localization of critical points in a lesson which uses, 
-cio- extensively. * ^ *^ 



37 



IV - 1 



Xqu can make TUTOR calculate things for you. For example: 



at 1201 ^ 

write Who is bufied 

irr Grant • S tomb? 
arrow 12j3l+3JJ8 



The -arrows statement as . written is- completely equivalent to . * 

"arrow 15J39". Or consider this: 

circle (4 

The radius of the circle irill be taken to be tljie square root of the sum 
of 41 squared and 72.6 squared. ^ 

Just about any expression that would have mad6 sense to your high school ' 
algebra teacher will be understood and correctly evaluated. Some a^lditional ''^ 
examples : 

Expression TUTOR Evaluation 

r 

3.^+5(23-3J/2 15^9 
o 2X3+8 14 (NOT 22) 



I Gin(3J3°) (See Appendix C for other functions 

(4+7)^(3+6) - 99 

' 6/5x1 J 200 (NOT 1.2x10-3) 

^ 

If your high .achool algebra is rusty, we remind you that "2x5+3" means 
"(2x5)+3" which is 13, not "2x (5+3) which is 16. The rule is that multi- 
plication is "more important" than addition or subtraction and gets done 
'first. If at some point you are unsure, just uafe plenty of parentheses 
around portions of your expression to make the meaning unambiguous. 



IV -.2 . * 

A similar point holds for division, wrfich is considered "more important", 
than addition or subtraction. "8+6/2" means "8+ (6/2) " which is 11, ^'^ot ^ 
!• "(8+6)/2" which would be 7. The only ticklish point is whether multiplication 

^ is more les^s "irhportant" than division. TUTOR agrees with most mathematical 
i books , and journals that multiplication is more important than division, so \ 

that "6x4/3X2" means " (6x4)/ t3x2)" which .is 4* Note that this means that TUTOR 
. considers "1/2(6+4)" to be "1/(2(6+4))" whiph is jJ.jJS, not "(1/2) (6+4)" 
which would be 5. Again, when in doubt use parentheses. You could write . , 

".5(6+4)" if you wish, which is unambiguous. 

'* • # ' 

Experience has' shown that students tend to write algebraic responses 
according to these rules, and making TUTOR conform to these rules facili- 
tates the correct judging of student algebraic arid numerical responses. 

Having seen how expres's ions are handljsd, we can introduce "student 
variables" which may be used to hold numerical values obtained by evalu- 
ating expr<^ssions. These stored results can be jised later in the**lesson. 
For example i a' "variable" might hold thfe student's* score on a diagnostic ^ . 

quiz, and this score could be used later to determine how much drill to * |^ 

give the student. -The storage place is called a "variable" because what 
it holds may vary at different times in the lesson. Another variable 
might ^cQunt the number of times the student hasr rec^dsted help, in whicli^ 
case the number which it holds would vary from jJ to 1 to 2) etc. 

0 

There are 15J3 "student variable^" which can .b^ used for storing up , * , 

• to ^5jS numerical values. These "student Variables" are unimaginatively 

called ' . ' ^ ) 

^ v1, v2, y 3, . . .v148 , v149, v15j3.| 



Later in this section we will learn how to give tl^em names which are - 
appropriate to their particular uses in a partidular lesson, such as ' 
"radius", "wrongs", ^'tries", "^poed", etc. But at first we'll just use 
their primitive names, v1 through v15j3. ^ •'' 

These variables are called studfent variables because each of the many 
students who may siitnultaneously be studying y6ur lesson has his or her own 
private sot of 15^ variables. 'You might use variable v23 to count 4ho number 
of correct rosponaoo on a certain topic, which will bo aifforQht for each 
student. If there are forty student^ working ,on your lesson, TUTOR is 
keeping track of jEorty different "v23'8", each one different.- This is done 
automatically for you, so that you can write' the lesson with one individual 
student' in mind, and v23 may bo considered simply as containing that individual 
student's -count of correcj: responses. Thus one student might be sent tb a 
remedial unit because the 6ontents of his variable number 23 show that ho 
did poorly on this topic. Another student might, be jiimped ahead because the 
contents of her variable 23 indiaate an excellent grasp of the material. It 
is through manipulation of the stpdont variables that a lesson can bo 
highiiy individualized for each student.'' • 



ERIC 



?r . •. 39 ^ 



Variables are useful in building certain kin<is of displays. Let's / 
see haw to build a sul^routine' which can draw a ^^half-9irc3re in various sizes, 
depending on variables which we .set up. 



(x-radius,y) 
(v2-v] ,v3) 




;;circle radius , x ,y , J3 , 1 80" 

^circle y1 ,v2,v3 ,k ,^B0) 

"draw x-radius , y ; x^|idiu3 i y " 

(draw v2-v1^ v3;v2+v1 , ,v3) 



(x+radius,y) 
(v2+v1 . ,v3L 



In order to ^ecify the si 
ibn, we must 3pGte4#y^>i-^j:A^^ 



/ 



■ •> 

size of tfie figure and its location on the^ 
screfen, we must spe^s^y^jx-.XtX.^^s and a center (x and y) . . If we let variable 
v1 hold the value *f or the radius, and let v2 and v3 keep the horizontal x 
and vertical y positions of the, center, wc can dr^w such a f igure withthe 
following unit: . ' 



unit 


halfdirc^ 




circle 


..v1 ,v2,v3,j3,18^ 


; ^5 18J3 degree arc^ 


draw ^ 


v2-v1 ,v3;v2-kyf,v3 - 


$$ horizontal line^ 


In order to 


use this subroutine 


wG might write 




^ r^^ - . 




' unit 


vary 




calc 


v1 <P1J3J3 


$$■ radius IjJjJ 


* calc 


v2 ^T5J3 


* $$ X centdr at ISjJ 


calc 


v3<P3^fj3. < 


$$ y qonfer 30 jH 


do 


halfcirc 




calc 


v2 cjf-VS+vl 


$5 increment x center * 


do 


halfcirc ' 


$$ radius and y unchanged 



The Qtat^^mjent "cale "va ^^^^ii 50" moans ''"perform a ealculatidn to put: 
the number 15J3 in variable v2". The statement "eale v2 <^v2+v1 " jnoans 
"calculate, triikc sum of the niimb'ors presently hold in variables v2.and v1 , 
put 'the rqau^t in variable v2"u In the present case this opda^atien will 
store the •niimbor 250 (150+100) in vairiablo v2 for use in the ooeond 
"do htilipcirc". Note that the neeond "do halfeirc" will use the 

original values of v1 and v3, which have nc^ boon changed. This unit will 
prod^e this picture: ^ 



and 
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The <}= symbol is called the "assignment" symbol i because it assigns 
a- nxamerical value to 'the* variable on its^ left. This numerical value is 
obtained by evaluating^the expi:ession to the right, of the assignment 



symbol. 



A slightly more complicated example ot a -calc-' statement is 



calc 



v30=5v2+v1 



which means "multiply by S the number currently held in v2, add. this to the 
number held in v1 , ^nd store *the result in v3." . In conversation yc\i might 
read this -^as "calc v3 §ssigried five v2 plus v1" or "calc v3 becomes- five v2^ 
plus V.I'*. . Notice that it is common 'practice to refer simply to| "v2" when. 
We really mean "the number currently held in variable v2" , ' 

,ti>': '^ The simplest possible -calc- statement merely assigns a .numb'er to a » ' 
.^^ariable> as in "calc. - v2<i=15j3" , It is permissible to make mdre^ tha;x one 
assignment in a -calc-^: * 

calc . v3 <f=v7^18.6^ 



This will assign the value .IS.G^.to both variables v3 and v7. 



* Giving names to variables; ' -define - 



your "programming can bfevmade much more ' readable by "defining"^ suitable 
names for the 'student' variables wliich you use. For example, in trfe units 
just ^!scussed,^*the 'quantities ^of interest were the radius and center (x and 
y) of the circular aire. We should precede such units with a- -define- stater 
ment': * ^ ^ 



y^'^!^ define r adiu s=v 1 
x=v2,;y=v3 



unit 
calc 



dp 

calc 

do 

* 

unit 



vary \ 
radius <^=1JJJJ 
x<:=15j3 

halfcrird 

x<J=x+radius 

halfcirc 



$$ names may* be 7 characters long 



$$ The command name,^calc- 

$$ ma^y be omitted on successive lines 



_ halfcirc 

circle radius,x,y,JJ, 18JJ . 

draw x-radiusiy;x+radiui^,y ■ ' ^ ,** . ' 

The rdef ine- statement tells TUTOR how to interpret the defined hames 
wh^n they are encountered later in expressions. The units are n^\^'much mojce 
readable than they were when we used v1 , v2 and v3. ' 
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Giving meaningful names to the variables you use is very important! 
After an absence of several morlths you yourself would have dif:^icu\ty in 
remembering what you are keeping in, *say, variable v26, whereas the name 
"tries" would remiftd you i|nntediately l^hat this holds a count of the hximber^ 
of times the student has tried ^to answer the question. The importance of 
readability is even more vitial if a colleague is working with yon on the 
materi&l. He- would find it extremely frustrating to try to figure out what 
you^ are keeping in v26,- So, ' o ^ . 

USE* -DEFINE-] - 

There should not be any v3's or v26' s anywhere in your lesson except 
in the -define- statement itself . Put all your definitions at the ^ very 
beginning of the lesson where you will have ready reference to which variables 
you are using, .'J* 

The only reason •we started out using the primitive v-names was to give 
a more concrete feeling for* the meaning of a studdnt variable. From here on 
we will use defined variable names, A preceding -define- statement is . 
assumed, % ) * ^ . v ' 

WARNING; Nprmal algebraic notation permits expressions such as S 
;"rcos6", but in TUTOR you must writfe "rxcos(e)" or "r (cos (6) ) " . i. 
That is, you must use an explicit multiplication sign between names 
(either your defined names such as "r" or TUTOR-def ined names such 
as "cos",), and you must place parentheses around the argliments of 
functions - the "6" in co'feO), 

^he reason for this is' that TUTOR cannot cope with the ambiguities of trying 
to decide whether an expression such as "abc" means "a^bc" (if there is a 
name "be"), or "abxc" (if there is a name "ab"), etc."* Later, when ye discuss- 
the important topic ot judging* studenj: responses, we will see that TUTOR can 
make rea^sonable guesses, wljen treating a student ' s algebraic response and 
can permit the student the luxury of leaving out multiplication signs and 
omitting peurentheses around function arguments. Biijt you; the author, are 
required to be more explicit in separating one^name from another. Notice 
that "ITangle" is f ine^ - TUTOR will recognize this as meaning "17xangle"., 
But "rarigle" can't be pulled apart into " (r) (angle)" because .you might 
have meant " (ran) (gle) ". * ' 




% 



Repeajied operations; the iteratiV(4 ^do- 



With very kittle effort we can- make other pretty designs out of our 
unit "halfcirc".^ For' ^example; . % 



uni^ stack . " - 

calc x<J=256 • ' 
\ :^adius<r7j3 

*/-p>do ' .halffcirc,y<S=1j3jJ,5ajJ,7;J 
' at - -312 

' write We used an 

iterative -do-. 




, , The effect of the -<|o- stat&nent is to set y to ^00 and do unit . \ 
"haifcirc", then set y to 17JJ (the starting value of ^00 plus an increment 
of 70) and do halfcirq again, and repeat. until y reaches the final value of 
38JJ. 'The format of the extremely useful iterative -do^?;? statement is 



do 



uni tname , index <=s tar t , end , increment 



In the tbove , example, the index "y" starts atMjJj? and goes to 38;J in . 
increments of 70. If no increment is specified, an increment of one is 
assumed: "do haifcirc, radius<?=:1JJ1 , 1JJ5" will make an arc five dots 

..wide: ' 




(Greatly enlarged.) 



43 



The iteratiye -do- statement also helps in making animations. The 
following statements will^ cause the "chalf-circle to move horizontally across 
the 3creen: " . * 



unit 


march^ 




at 


3120 


• 


write 


Move figure left to right* 




calc 


y <=28j3 " 






radius ^7 5 




do 


dllXill } A *>r— \ pp f O^p $ '^p 




do \ 


halfcirc ^ 


$$ 


at 


322^1 ' , 




write 

* ^ . 


All done. 




unit ^ 


anim 




do 


halfcirc ^ 


$$ 


catchup, 




$$ 


pause 


1 


$$ 


mode 


erase 




do 


halfcirc 


$$ 


mode 


write 





$$ draw final figure 



A 




We simply -do- unit "andsm" repeatedly for different values of x, 
the horizontal position of the figure on the screen. Uni:^: "an^m" does 
unit "halfcirc" twice, once to draw and^- once tp erase the figure interrupted 
by a one- second pause. The -catchup- command insures that a second will 
elapse from the end of drawing^ the f igurej|pn the screen until th^ beginning ^ 
of erasing it. 

Now that you have studied -define-, -calc-^, and -do-, ,you have learned 
the basic techniques of how to tell PLATO what calculations you want performed 
We have applied these tools to a variety of display generation problems, 
and lafeer we will use calculations for controlling sequencing in a lesson 
and for judging responses. Also, you have perhaps gained acjded insight into 
the value of a subroutine; look at how many different ways we have used that 
single unit "halfcirc"! 
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Showing the value of . a Variable 

We have learned how to calculate and how to store results in variables. 
How do we, show these results on the screen? If we perform: 

■ ' / ' / 

calc y<=5sqrt(37) / 



J 



(where "sqrt(37)'* means "the square, root of 37") how do we later show the 
value of y? Assume we have defined y. Perhaps we could use this: 



write 



No, that won't work; that will just puf 
-write- command is basically a cievice fcr 
for sjiowing the value contained in a vai 

show y 



the letter "y" oji the screen. The 
displaying non-veirying textj not 
iable. We need another command: 



This will sho-vf the value of y in an appropriate format "(-show— picks an 
appropriate number of significant figures and will use a scientific format 
such 'as 6.7xij3^3 j_f ^Yie number is large enough to Require it). By using 
^show- instead of -write-, you tell TUTOR that you want the stored value 
> to be shown rather than just the characters in the tag. 

er ' , ■ 

The -show- com|Rnand Will normally cljoose 4 significant figures, so 
that a typical display might be '*-23.47'*. You can specify a different 

se'oond "argviment" (arguments are the individual ^pieces of 



value by giving a s 
the tag of a statemjent) 

show y , 8 



$$ 8 significant figures 



The arguments of the -show- can, .of course, be complicated expressions: 



show 1 j3+3j3cos (2angle) , forma t+2 



In fact, it is a general rule that you can use complicated expressions any- 
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where in TUTOR statements: for example, "draw 



5rad+225 , 34L; 1 23-L^ , 28L" ! 



Here is a short program which uses -show- to display a ^able of square 
roots of the integers from 1 to 15: 





N=v1 






vlnit 


r&ots^ 






it 


31j3 


$$ write titles 


for the two columns* 


vrerite 


N 






an 


325 . 


\ * 


^1/2 


wr\tp 






do \ 
* \ 


root,N<5=1 ,15 


' Z ^ 
3 
A 


y. 732 


unit 


root 


5 

6 


2. 236 
2.4-19 <^ 
2.646 


at 


4li3+1i3j3N 


< 7 


show 


N 


0 


2j^828 , 
3^ 


at 


425+1i3jZfN 


10 


3.162 


show 


sqrt(N) 


1 1 

, 12 
X J3 ^ 

^ IS 


3.31^ 
3. 464 
3.606 
3. 742 . 

3.073 



The last statement could also be wfitten as "show N^^". This 
technique of making table^, including the use of ^he -do- index (N) to 
position the displays (as in "at 425+104n") is 
tool . 



irapo3:tant and powerful 



There are other commands for displaying wa^riables: -showe- (exponential). 



-showt- (tabular) , -showa- (alphanumeric) 
trailing zeroes) . These are described ip 
mentioned in Appendix A 



Although -write- is basically desig;ied for non-variable text-, combination 
of £ext and variables occur so often tha : TUTOR makes it easy to "embfed" 
a -show- command within a -write- 

write The area was <(s, 13. 7w]6)> scju^re, miles. 

The embedded "s" indicates a -show- command and the remainder "3 3.7w,6" 
is its tag. Other permissible abbreviatipns include "o" (showo) , "a", 
(showa) , "e" (showe), "t" (shoWt) and "z"! (showz) . The above -writpT state- 
ment yis equivalent to * 

write The area was 
show 13,7v^6 
write square miles. 



-showo- (octal), -and -showz- (show 
detail in reference material 




/ 



Passing arguments to subroutines 



When you write "show 13.7w,6", you dire passing two pieces of information 
to the -show- command. You are givi^ig two numerical "arguments" (13*7w'*and 6) 
to the TUTOR machinery that performs the -show- operations. Similarly, we 
created a half-circular arc with "circle radius, x,y,j3^18j3" in which we passed 
five arguments to the TUTOR circle-making maqhinery. Sometimes certain 
argximents are optional: "show 13.7w" willl use a default second argument 
of 4 (significant figures) , and omitting the last two arguments in a -circljei^ 
command ("circle radius ,x,y") will cause a full circle to be drawn rather 
than an arc. When we pass one argument to the »^t- command ("at 1215"j), 
we mean course grid; when we pass two argument^ ("at 125, 375")^' we^ meaji 

fine grid. 



This notion of passing arguments to TUTOR \commands, with, some arguments 
optional, also applies to your own subroutines,! such as unit "halfcirc". The 
."halfcirc" subroutine needs three arguments (radius, x, and y) to do its job. " 



* 
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We passed these argvunents by assigning values to variables and letting 
"halfcirc" pick up those ^alues and use tjfcem: 

define radius=v1 ,x=v2 ,y=v3 

unit vary * » , 

calc radiu3'O=1j80 - ^ 

X<J=:15J3 

y<?=300 
halfcirc 
radius <?=^5J3 
halfcirc 



{ 



do 
calc 

do 

* ■ / 

/ 

unit halfcirc / jf s 

circle radius,x,y ,J3>1 8J8 
draw x-radius,y;x+radius,y 

Notice that the second -do- will use the origrinal "x" and "y"# since these 
variables have not been changed, It is ^s though we passed only one argu- 
jneHi^ ("radius^') to the subroutine, f r 

' TUTOR permits another way of writing this sequence which looks similar 

*to the v^ay one passes arguifients to the "built-in subroutines" (-show-r, 
-circle-, -at-, etc'.): * . * 



define 


radius=v1 ,x«v2,y=v3 








ujait 


vary 








do ' 


halfcirc(1^fj3,15j3,3j3j3) 








do ^ 
* 


halfqirc(5j3) 








unit 


r 

halfcirc (radius, x,y) 








circle 


radius, x,y,j3, 18j3 








draw 


x-radius , y ; x+r adius , y 









The statement "unit halfcirc (radius, x,y) " tells TUTOR that when this unit 
is done as a subroutine, arguments are to be passed to it. The statement 
"do halfcirc (10)3, 15J3,3J3J3) " <tells TUTOR to pass the listed arguments to y 

the "halfcirc" subroutine for its use. The arguments are passed in the 
ordei: listed: 



do 



halfcirc ( 1 J3j3 , 1 5j3 , 300) 
.1 



3 (pass 3 arguments) 



unit 



half circ (radius, 3i,y) 

V 
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These variables are now set for* use in the subroutim 
though we had assigned values to "radius", "x", an( 
some arguments are omitted, these are not transferr^ 




is pirecise-ly as 
using -calc-. If 



do 



halfcirc(5j3]f 



(pass 1 argument) 



unit , half circ (radius,,x,y) 
*^ 

In this case the variables "x" and "y" have not b^4n assigned new values, ^ 
so they retain the values they had. (These values are 15J3 and 300, but they 
could be different if there were^ -calc- statements in "halfoirc". For 
example, if we append "calc >[<J=75" to the end of unit "haljfciarc" , "x" 
would now be 75, although it was lSj3 during the making ^f the first display,* 
having been passed this value by the first -do-,) 

Arguments to be passed need not be simple numbers. Each argument can 
J3e a' complicated' expression. The expressions are evalijated^ then passed in 
order r • • : ^ 



y . do 



"halfcirc (3.4radius-25,radius+25y,2j3^+y) 
1 2y 



unit halfcirc (radius, x,y) 
It is as though we had written • 




calc argi ^3 . 4radius-25 
arg2 4=radius+25y ^ 
arg3<^2j3j3+y 
radijis <3=argl 
x4?5arg2 
y<}=arg3 



Just as the -at- command handles its arguments differently aepenaj-ay uu 
the number of arguments (one for coarsfe grid and two for 'fine (ii±d),^Qo it " 
'is possible for your subroutines to do such things. There is a XTUTOR-def ined 
"system variable" named "args" which always contains the number of arguments 
passed the last time a subroutine was done. By "system variable" we mean 
a variable separate from the student variables (v1 through vISjJ) whose 
contents^are assigned by TUTOR rather than by /you. You do not define system 
variables^ they are already defined f^ you. • (Indeed, if you say 
"define args=v3" you will override TUTOR'S definition of the meaning of 
"tjirgo", ,^o that "args" will mean "v3" rather than "the nximber of arguments 
passed to a su'Brbu^ne ".) In chapter VI (Conditional Commands) you will 
see how you could db^ different . things in a subroutine conditional on the 
value of'"a^gs", similar to the kind of thing the -at- command does. 
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Oxir subroutine "halfcirc" usoo three Gtuden): variables: v1 , v2, and v3, 
defined as "radiVis"; "x"*, and "y"* Another subroutine could use the dame 
variables\^ for cairrying out its work, but it must bo kept in mind that -do-ing 
this subroutine will af feet v1 , v2, and v3, ^ince argum^rsts will be passed. 

Suppose, one subroutiine uses another, with "ne'feted" -do-s. like this: 



do 



unit 

do 

calc 



unit 



a/(5) 

PASS 

A (v11) 
B(3+v1l) 
v11<}=1j3v1 V 



B(v25) 



$$ v11 <}=5 




$$ v1 10=5)3 

/ 



PASS 



$$ v25<3=8 



l^iable v11 ends up with the value 50. It is advisable to use different 
variables in the two subroutines. Here unit A uses v11 and unit B uses** 
v2§. it can lead to cpnfusion or even logical errors if B also uses v11 to* 
do its workj since -do-ing B will affect the value of v1 1 used by A. Here 
ia the strugture to be avoided: ^ t 



do 



unit 
calc 



unit 



A(5) . 
PASS 

•V 

A(vll) 
^BOivll) 
Vl1<^1j3y11 



B(v11) 



$$ Vl1<^=:5 




PASS 



$$ v11 ^^SjJ 



$$ v^y<pB 



Now variable v11 ends up with the value 8^ rather than 5j3. This is due to the 
effect on v11 of the "do B(3+v11)" statement, which assigns the val^ie of 

8 to v11 by passing the argument. 

This concludes our discussion of' calculations for now. We can calculate, 
save, results, use them to make displays, and show the values. In the next 
section we will use calculations in association with g^■^ding the sequencing . 
of a lesson. 
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V. ' Sequencing of unit^ within a lesson 



We have diDcuGsed many units which make different kinds of displays. ,^ 
in some 6ad&^ the main units had other units attached to them by means <of 
-do-. Upon completion of a main unit, the student can proceed to the next 
one* by pressing NEXT. A greater variety of inter-unit connections is needed 
to build a complete lesson which includes optional* help sequences, branches 
to remedial sections when the student is having trouble, an index that gives 
the student some control over the order of presentation, etc. fn this section 
we will discus^s in. more detail how to build rich interconnections into a 
lesson. • This discussibn builds on the introduction to siach matters presented 
in chapter I. V 

It is often desir€ble to skip over some units, particularly if they are 
used as subroutines, not as main presentation units. Wq/have seen that this 
can be done by using a^-next- cctanaijd to name the main unit which is to 
follow: " - 



unit 


one 


next 


two 


do 


dispone 


at 


1515 


write* 
* 


This is unit one. 


unit 


dispone 


calc 


radius <f= (x <)=y ^200) -5j3 


do 


halfcirc 


unit 


two 


at,^ 


412 , 


write 


This is unj.t two. 
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When yuTOR jDegiris "executing" the stateineiits in uftite:"one" , it starts' out 
assuming that tljtfe next physical unit, unit "dispone", ,Will bq the/ next 
main unit. However ^ TUTOR encounters a "next two" statement which says, 
'.'No, make a note that uri3^ "two" will >b'e next, rather than, the ne&ct- physical 
unit". The. "do dispone" is then executed, which involves drawing a 

figure. Finally, we write "Tfiis is unit one*", which is at the end , of unit 
"one". Nothing more will happen until the student presses the NEXT key, 
^at which time TUTOR looks at its notes and finds that unit "two"^ comes next, 
whereCipo'n it) erases the screen and starts executing unit. "two". Hiad wp , 
not inserted the- -next- command, TUTOR would have gone on to unit* "di^one" 
by default. ^ ' 

) 1 ' V 

To put it another way, TUTOR had a pointer which tells which main "Unit 
should come next. At the beginning oTg a main unit TUTOR places zero iri^this ; 
pointer to indicate , that tTie next physical unit should be next. If no L / 
-next- command is dncountered , wo reach the end of the unit with the pointer J 
still zero, and, when the student prejases NEXT, TUTOR will by default 
proceed to the,ne>pi physical unit. On the other hand, if we encounter a. \ 
-next- command anywhere in the unit, it will alter this pointer so that \ \ 
•later, when the', student presses NEXT, the pointer is non-zero and is pointing 
to whatever unit we have specified. 

' ..v'^ • _ ■ 

It* ^should be clear from this discussion that the -next- comma-nd can 
be e^Gfbyted anywfiere in the unit without changing its effect. Nevertheless, 
it i^ ^important to place the -next- c?bmmand near the beginning of the unit . , 
The"^dvantage is ^that you can then see at a glance what is the mailn sequence 
flow. If the -nQxt- command is buried far down in the unit, you have to 
• hunt for this .crucial information. You put such unit information at the 
beginning pf a unit' for the same reason that you define appropriate names for 
the variables you use: you or a colleague may have to read through the 
lesson months after it was written 1 ^ • . ? 

riere is another example which ma^ Illuminate the manner in which the* 

-next- pointer is handled: 
> 

unit* silly 

next A • .' 

next B , 

next ' C , 

unit sillier ' , ^ : j 

Well, what unit will be next? Answer: unit "C"l The pointer starts out 
cleared' to zero (which implies the ne3j:t physical unit) , then getd sot to 
"A", then to "B", and finally to "C". J Each aucceoding -next- command over- 
writes what had previously -been in the pointer. V ♦ 
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it is also possible to clear the next pointer yourself by -next- with 
no tag or "next q" ("q" for " quit specifScing something") . Either ^of these 
forms will clear the next pointer so that the next physical unit will come 
next. In other, words i the sequence 



unit 
next 
next 

unit 



start 
silly 

q 

again 



$$ or just "next" with no tag 



will proceed from* unit "start" to unit "again" because the '*next q" cancels 
' the "next silly". Such seemingly meaningless manipulations are ""mentioned 
hero for completeness and as aids to explaining how TUTOR handles a. unit 
pointer such as that associated with the -next- command. Later these^ mani- 
pulations will maKe more sense.* The important' point is that you k\a\^e complete 
control aver the pointer^ You can set it or clear, it with an appropriate 
-next- command. ' ^^^^i^i;^ 

• 

The existence of "next q" (and related statements) means that 
"unit ^ q" is not a permitted statement: you are not allowed to ijame a 
unit "q" because the possible confusion. For^ similar reasons we wj^ll see 
later that a unit cannot be name4 "x". ' * ' 
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Another use of pointers is in. specif ying\ optional "help" sequences which 
'the stude^it can request by pressing" the .HELP kfey. Such optional sequences 
are important tools in making the lesson cat6r to the needs of individual 
students' of diverse background sN^d abilities. Herd is an example: 4 

dippeif V 
words $$ spQCify a 'help unit . ^ . 

1215 , ' ^ t 

Today we will di'scuss Ursa Major .d^k ' 



unit 



/-J==>help 



at 

write 

janit 
help 
at 

write 



$$ speci'fy a help unit 



dippy 
wordg» 
2213 

Ursa Maj^r is in the northern sky. 



unit 
at 

write 



unit 
at . 
write 

en^ 



words 
'1525 

Ursa Major is the Latin name for the , 

constellation which contains 

the "Big Dipper". 

(Press '^NEXT for more help, 

or PresQ- BACK, ) 

word32 
1525 

"Ursa" means "boar". 
"Major" means "bigger". ^ 



\ 

N , , 




1 " V 


»<L P t ««« .« 1.(1 




< '* 1 ft ' 

i : ' ■ 
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The -help- command io used to specify a "help" uni^t,^ which may bo just 
the first unit in a long help sequenco. If you provide .help this way, 1:hG 
'stud^t can got it by pressing the HELP key. (Conversely, if there is.no 
-help- command, the HELP key has no effect) . When the student enters the 
help sequence, his screen is erased to cflear the* way 'for the display generated 
by the first help unit. The stiidant may at any tame press BACK ox shift-»BACK 
to return to. "home" base", the main unit' he was in when* he requested helji, A 
'"baso*^ point^^ retains the name of • the "base unit" r'- jfhe unft to return to. ^ 
In the gxamplq', if yoS presq HELP in the base unit '/dippy" > TUTOR remembers 
"dippy" and jumps to "words", from where the BACK key will take you back to 
"dippy V. If instead you press NEXT, you advance to "words2", where again 
you can press BACK or shif t^-BACK ^o return to "dippy".. From "words2" 
you will also return to "dippy" upon pressing NEXT because the -vend- command 
in unit "word82" signals the end of the help sequence. ' \ 

It is almost as though the student had two screens he can look at I He 
starts the leospn in the first \init a normal, i>on-help sequence and 
advances in this sequence until he rAuests help, at which point he turns 
his attention to a different, parallel sequence of units', almost as though 
he turned to use another terminal bofidp him. He can get back to the ^ 
original sequence by pressing BACK, tro as though 'he turned back to the 
terminal in front of him. The ucefujjress of such a parallel s6quencG is ndt 
limited to help sequences but can b^Tised to provide review, a desk cal- 
cijlator mode, a dict;ionary of terms, tables of data, etc., or for any situation 
in whiich the student temporarily needs a second terminal "off to the side". 

It is possible to access yet another help sequenco when you are already 
in help sequenco, but BACK will return you to the original base unit, not 
the help unit you wore in when you requested the second help soquonpO. « This 
is due to the fact that there is only one base pointer, which icf^^Uot changed 
by the pecond help request. If there is already a base unit specification, 
TUTOR 



d^es not alter it.% 



You can' alter the base unit pointer yourself with a -base- command. ^ If 
you put a -Dase- command with^ no tag in un^ "words" you will prevent a* 
return to "dipper" or "dippy". The -baso^ command with no tag or a "base q" 
statement clears the ba,qe pointer solt^j^rc ^TOR forgets there was any place 
to return to and tliiinks that you are not in a help sequence. Ofdxx should 
notice that the -end- eoitimand in unit "words2" is now ignored; tho^-ond- 
command has no effect in a non-help sequence.) This -base- (blank or *"q"^ 
tag) is used quite often ,^ for it is frequently convenient to put tho student' 
into a non-help sequenco oven though ho reached a certain point, by pressing 
HELP. TUTOR automatically clears the bine pointer whonoyor tho student 
reaches the corresponding base unit, by whatever means. 

You can .change tho base poii)tolr to point to some unit other than tho 
original one. Imagine that wo place in unit "words" tho statement i 



base dispone 



This means TUTOR will eventually return to "dispone" rather than "dip]per" 
or "dippy". This is occasionally a useful technique. For example, xo^^ 
fcight like to reytu^n to a tinit just' ahead of the original one in order 'tp 
ease back into the original context. Notice, too, th^at while -base- with 
I no tag (or "q'^). can changfe a help sequence :into a^non-help sequence^ so 
"base . unithame" can change a non-help sequence into a help sequence by 
nairiing a unit to return *to. 

.You probably will not need all of the features oJE -help^, -base—, and 
-end— des'cribed above > but hopefully the discussion has clarified how-, they 
do their wprk. We have also picked up some terms s/hich will be quite useful 
in later discussions: we can now talk about "non-help sequences"^ of "main 
units" and "help sequences" of "main units". It should also be pointed out 
that a base unit may have other (auxiliary) units attached to it by -do-; 
and, of course, we return to the base unit itself, not to one of these 
attached ^nits, even if the -help-, command is located in an attached unit. 
More generally, a lesson may be thought of as a collection of main^units 
which have attac^hed units, and the students moyes from one main unit to - 
another. He may enter, a help sequence of main units, each of which may 
•^do*- attached units. While he is in the help sequence, TUTOR remCTibers 
• which main unit is the "base" unit to feturn to when -end^ is' encountered 
or when BACK or shift-BACK is pressed. ^ , • 



HELP ^ main 



STFIRT 



(opt 1 ona 1 ) 



.NEXT 



1^ 



I attached 




katt ached | — 



attached 



I attached 



I attached"! 



VNEXT 



main 
end 



Return tq 
base unit 



You may have realized that -help- and -base- are quite similar to -next 
in that all three commands set pointers (which have different uses, however) 
In p^tictilar, if we say* . " . _ " 



unit 
heJjD 
help 
help 



lotshelp 
a 
. b 
c 



then the last one wins-; — the help pointer ends up pointing at unit "c**. / 
We saw earlier that -nejct- works this way. Similarly, "help q" or -help- 
with na ta^ -will clear i:he help pointer, thug making the HEfP key inopei^ive. 

YouTmay find it helpful to think of a help sequence as a "slow" syijroutine 
^Whereas a -do-' command iakes us to a unit aitd right back again, -rhelp- makes 
possible an optional juiAp to a unit»or ^to a sequen^^e of units where the student 
,may study for ^nahy minutes before, returning to the base unit. Aside from 
the "sldwness" and the necessity of pressing keys to go and return, tjiire is 
one fundamental^ difference from a -do- situation: we return from help to^ 
the beginning of the^bape unit ai\d re-execute the statements in the unit to 
restore the original' dafeplay, whereas the return from. a -do- is to the state- 
ment folloviing the -doW. 



This last point is suf :^icien;tly impor^nt to warrant an example; 



|u;fit. 

vrite 
::alc 

Wit 

r 

^ite 

unit 

clt : 
write 



a" must be define^ 



initial 
2S13 
Set "a" 
a<0=^J 

rejSfeat 
■ trivial 
2715 

Incre^ient 

trivial 
312 

Press NEXT 



(Of course, 

press, HELP, tjhen BACK, we will 
increases ^by Cne^ on every returl 
to the begir^ri ing of the base un 




<(s,a<S=a+1 > 



BACK. 



) If while in unit "repeat" we repeatedly 
cepeatedly increment variable "a"^ it 

f rpm the help sequence because the return 
jLt, and all the Stateni^nts in unit "repeat" 
are re-exe/::u|tied. This is necefiiary to restore to the screen the display' 
associa^prd with unit "repeat" , ^ince the, entire screen is erased^when' the 
HELP arffl ^Ac|c keys are presjsed. 

This e^Jinple brings up a fundamental 
olA "initiali[4^tion". We might upe such^ 
of \times the btudent presses the 
pirt\the "a^aVl"/in the help uni 
for \help> number of wrong answer 



IS 



rogramming point: the question 
tructure for counting the number 
LP key \although we would then probably 
) • lA. oro^r to ^count something (requests 
etc.\ , it necessary to "initialize" 
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the* counting variable to zero before starting the process, and this initial- 
ization must precede and be outside the process itself • This 'can perhaps 
best.ijfe seen by moving the statement "calc a<i=jS" from unit "initial"- to 
the beginning of unit "repeat": 



unit 
help 
c^lc 
at 

write 



repeat 
trivial 
a<>=JJ ' 
2715 

Increment 



"a" to <s,a<0=a+1J> 



Imagine pressing HELP (and' BACI<) repeatedly. Now there^ will never be a 
change in the displayed value of "^", because on each return from the hd^lp 
unit "a" is again reset to zero, whereas previously that was done only with- 
in unit "initialV. 

We will ^encountdr the question of initialization again and again in 
various gu^Lses. "We did not mention thejse matters earlier partly because 
the iterative 



-do- command had the inii:Lalizatio^ built-in 



do 



zonk,i<5=5, 13 



means "initialize 'i' to 5 and do 'zonk',\ then rejieat by incrementing 'i' 
by one until it reaches 13". 

Let u% hasten to say that initialization qudjstions are, of course, not 
unique to programming. The principal and interest due monthly on your car 
or house loan depend on the initial conditions of the loan. 1^en you make 
fudge, you start with certain ingredients in the mixing bowl (the initial 
condition) and then you beat the mixture 2j3j3 timfes. You would no more ^ 
restart with' new, unmixed ingredients after each beating stroke than you^ 
would reinitialize a count of student errors after each attempt. In other. ^ 
words, questions of initialization are mainly questions of common sense, and 
we will make explicit j:omments about thd^^e matters only where confusion is 
likely. In the case of a return from a help sequence, you might have, thought^ 
that TUTOR remembers the entire display originally made by the base unit, .but, 
as we have seen, it must re-create the display by re-executing the commands 
in th6 base unit, which, has side effects related to initialization^ quest^ions. 
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Now let's move the "calc /a<J=:jJ"^ back to unit initial" and modify 
the unit to look like this: 

linit initial 

calc a<d=JJ . ^ k 

jumR, repeat $$ do not WAit for the NEXT key 

The -jump- command acts much like the student pressing, NEXT: the ^screen 
is erased and we move to a new main unit. The -jump- command is particularly 
useful in association with initializations, as in this example, where it is 
necessary to separate initializations from a process in a different unit. 
^It wj^uld be superfluous to show the student a blank Screen and to make the 
student press NEXT. Indeed, it should be a basic rule to minimize 
unnecessary keypresses so as not to frustrate the student. Notice that 
-jump- is immediate (like -do- and unlike the -next- or -iifelp- commands) 
and that statements that follow -jximp- in a unit will^ not he executed 
(unlike -do-, -next-, an^ -help-). 

The base pointer is not affected by a -jump-:, 'it remains zero if 
we are not in a help sequence, and' it retains its base unit specification 
if we are in a help sequence. The -jximp- simply takes uis from one new 
main unit to another without having to press NEXT.- Since it starts a new 
main unit, a -jump- cancels any -do-s which have^been encountered;' there 
will be no return from those -do-s. 

» ■ 

When moving from one main unit to another, by -jump- or by pressing 
NEXT, the entire screen is.^ erased unless the first of these two main units 
cqntains an "inhibit erase" statement. ^ 

Since -jump^ takes the studeht from one main unit to another without 
altering the -base pointer, it is possible to take a student to a help 
sequence immediately without his pressing^ HELP: 

V 

unit model 



base model 
jump modhelp 



I 



Initially, the base pointer is zero because we are in a non-help secjuence. 
Then a -base- command is used- to. s^t the base pointer to unit "model" (the 
main unit we are presently in)." The -jump- takes us to unit "modhelp". Now 
we are in a help sequence because the base pointer has been set. The return 
from the help sequence will be to the beginning of unit "model". Note the 
difference between "base model" and "base^ q" in unit "model'*: a 
"base q" stateme;jt would clear the already-cleared base pointer, whereas 
"base model" sets it to "model". 
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Summary of sequencing commands * 
: ^ 

You have^^i learned many commands which enal^ie you to control the sequencings^ 
of units in a lesson. These include commands which set pointers t'^next-, 
-help-, -base-, etc.) and a couple of immediate branching commands (-do- and 
- jump-N} . You have seen how to have two parallel sequences of main units — 
a non-help sequence and a h^p sequence — and have used the -end- command 
to terminate a help sequence. Additional aspects of the 'connections among ' 
units will be discussed in chapter VI in the section on the -goto- command. 
We recall that the LAB, DAT^^, and BACK keys are activated by -lab-,' -data-, 
and -backl^ commands, just as the HELP key is activated by the -help- command. 
The shifted HELP, LAB, DATA, NEXT, and BACK keys (abbreviated as HELPI, LABI, 
-DATAI, NEXT1, and BACK1 ) are activated by the commands -helpl-, -labi-, 
-datal-, -nextl-, and -backl-. (Wheji in a help sequence the BACK or BACK1 
keys will cause a retdrn to the b^e.unit unless th^e are exj51icit -back- or 
-backl- commaflds to (alter this. ) Here is a unit whiojh uses many of these 
commands : " 



unit 


central 


help 


uhelp 


helpl 


index o 


lat) 


simulate 


labi , 


calc 


data 


data 


datal 


news , 


at 


1314 


write 


Priess 




HELP for asSjjLStance, 
shift^HELP for an index, 
LAB for simulation, 
^ shirt- LAB for* a calculator, 

DATA for tables of data, 
shift-DATA for class news. 

This is an extreme case, but this unit gives the stuSent six choices of help 
sequences, and which help sequence is entered depends on which key the student 
presses. In any of these cases- the eventual return will be to this base 
unit. The commands -next-, next!-;, -back-, and -backl- are somewhat different 
in that these do not cause a help sequence to be initiated: pressing the 
corresponding key does not alter the base pointer. 

The same conventions apply to all these commands. In particular, a 
blank tag (or "q") disables 'the corresponding key by clearing the associated 
pointer. A non-help sequence can be changed into, a help sequence by specify- 
ing a unit to return to with a "base unit" statement. A help sequence becomes 
a non-help sequence if we encounter a "base q" or "base" statement, since 
these clear the base pointer. • , , 
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It is important to point out that all the unit pointers [other than 
"base" are cleared when we start a rrew m^in unit (either by ^jump- or by 
pressing a key such as NEXT, BACK, or HELP). 

Notice that -jump- and -do- are basically author-controlled branching 
commands, while -help-, -back-, -data-, etc., permit the student to control 
the lesson sequence. 

There is another way to enter a help sequence which is particularly 
^u^eful in offering to the student an, index to the various parts of the 
ip5SSon. Suppose the lesson ^s organized into chapters or topics and you • . 
wish to let the student choose, his own sequence. In particular, he can 
skip ahead, go back, or review material, tt is desirable that he 'be able 
to go to an index or table of contents at any time. One way to provide 
access to the index is to put a "data table" statement in every main 
unit. Then th,e student can hit the DATA key and jump to unit "table" at any 
tjlme. Unit "table" would "fegntain a list of topics for the student to choose 
from, and it should contain a "base" stajiement to insure that the chosen 
topic be entered^ as a base sequence. Another Way to provide this kind of 
index is by means of a single -term- command: 



<5= 



unit 


table 




base 






term 


index 




at 


1518 




write 


Choose 


a chapter : 




a) 


Introduction 




b) 


Nouns 




c) 


Pronouns 




d) 


Vea:bs 


arrow 


1822 


answer 


a 




jump 


intro 




answer 


b 




jump 


unoun' 




answer 


c 




jump 


pron 




answer 


d 




jump 


verb 





The presence of "term index" in the unit "table" makes it possible for the 
student at any time to press the TERM key and type "index" to reach unit "table", 
(The TERM key is ^:he shifted 7VNS key on the keyboard.) When he presses TERM/ 
TUTOR] responds by asking him ^at the bottom of the screen "what term?*^ whereupon 
he wcmld type ."index". He then reaches unit "table", where he can choosy 
a chapter. You can see that -term- is complementary to -help-: -help- in 
a main unit specifies ,where to* go if HELP is pressed while in that main unit, 
whereas the presence of^ -term- in a unit specifies that the unit can be 
entered from anywhere in the lesson. It i's an error to put another -term- 
command with the same tag in*einother unit, for then TUTOR doesn't know which 
unit to enter. 
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The namS -term- stems from an early use of this kind of facility to 
provide access to a dictionary of "terms" — special vocabulary used in a 
lesson. In such an application there are as many help units as there are 
terms to be defined, and each unit has an appropriate -term- command: 

unit cardinfo 
term cardiac 
at 19iJ7 

write "cardiac" means "pertaining to the heart". 
V end 

Except for situations of this kind, it is strongly recommended that you 
limit yourself to hjpiving only one unit with, a -term- in it, and its tag be 
"index". This greatly^ simplifies the instructions to the student on how 
to use the lesson and reduces to a» minimvun what he must remember in order ^ 
to move arouhd in the lesson. In 'the index ur\it you describe the' various 
options that are available. Even f or ^providing a dictionary of terms, thi^ 
scheme is probably preferable — one of the options could be "dictionary of 
terms", ^ which in turn would show a list of the ^iprds whose definitions are 
availabie^ 

It is possible to hav^ additional -term- commands in the unit to provide 
synonyms: *• iv 



unit table 
base • 

term index 

term contents 



term choice 

at 1218 ' 

write Choose a topic... 



These additions insure that the student will reach this unit by TEwM- index, 
or TERM- contents, or TERM-choice. 



The -imain- command 

An alternative to "TERM-index" is to tell the student to press a key 
such as LAB to reach on index page. If this index is in unit "table", 
you must then put the statement "lab table" in every main unit, since 



•j 
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all unit pointers are cleared when a new main unit is ente^red. A better 

way to do this is to use an -imain- command which spgcifies a unit to be 

r 



way 

done initially in every main unit: 



imain 



setit 



unit a 



unit b 



^^nit 



unit 
lab 



setit 
table' 



IS 

EQUIVALENT 
TO 



unit 
do 



unit 
do 



unit 
do 



unit 
lab 



a 

setit 



b 

setit 



c 

'setit . 



setit 
table 



The -imain- command names unit "setit" to be done at the beginnings of every 
main unit. 

You can specify all kinds of initializations to be performed in each 
main unit. For example, you might advertioa the LAB key with this display 
at the bottom o/ the screen: 



Press LAB for an index 



In this case you would write something like 
imain setit 



unit setit jif 

lab table o 

at 322J3 

write Press LAB for index 

draw 312J3;3144;3244;322J3;312J3 

Now the display will appear with each main unit, 3nd the LAB key will be 

activated. ' ( t 
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^ The -imain- command sets a pointer, just as the -help- aAd° -base- 
commands do. You can change the associated ui?it by executing' another 
-imain- command: 



imain setit 



imain other 



You car]k/stop having an imain-associated unit done by using "imain q" 
or "ii(ig[in" (blank tag) to clear the -imain- pointer. 

While any key may be used to access an index, many authors have agreed 
to use shift-DATA, in order to provide some uniformity from one lesson to 
another. This reduces the number of new conventions a student must learn 
when studying new material. y 

There ia a oimilar -iarrow- coflonand which can be used to specify a 
unit to be performed every time a student enters a response. If the -iarrow- 
command ic itself located in the -imaiti- unit, all -arrow-s will be affected. 
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VI. Concmtional commands 



It is important to be able to specify the sequencing of a lesson 
conditionally . We would like to jump past some material on the condition, 
that the student has demonstrated mastery of the concept and needs no further 
practice. Or we would like to take the student. to a remedial sequence con- 
ditionally, the condition being poor performance on the present topic. Or 
which heip sequence we offer might be conditional on the number of times 
help has been requested. All of these examples imply a need for conditional 
sequencing or branching statements; where the con4i-tion may be specified 
by calculations involving the status of the student. 

a 

The usefulness of conditional branching is hot limited to the sequencing 
of major lesson segments; but extends to many calculational or display 
situations. For example, we might need to -do- conditionally one of sev- 
eral possible subroutines in the course of presenting a complex display to 
tlffe student. This chapter will show you how to perform these and similar 
^nditional operations. , 

Here is an exfample involving a conditional -do- statement: 



unit 
calc 
jump 
* 

unit 

next 

at 

do 

at 

write 
calc 

unit ^ 
write 

unit 
draw 

unit 
circleb 

unit 
write 



setup 

home 

home 
home 

N , neg , uzero , One , utwo 
1215 ^ 
N equals <(s,N)>. 

neg 

Unit "neg". 
uzero 

;210,26^y;2^y6^y;2^yi^y 
One 

2^^,25^,25^,^,27^ 
utwo 

Unit "two". 



The now element is the conditional -do- statement in unit "home". If N 
is negative, that statement is equivalent to "do neg". If N is 

zero, the statement is equivalent to "do uzero", and so on: 
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do. N,neg,uzero,One,utwo 

V 

is equivalppt to ^ - i 

' do neg» if N is negative 



do uzero jif N is zero 

do One if N is 1 

do utwo if U is 2 or greater 



Note that unit "utwo" will come up repeatedly because it is tjti6 last unit 
named in the conditional -do- sjiatement. The list of unit names can be up 
to long: 

do ' N,neg, uzero, One, utwo, dispone, 
zon , 2ip , figure , ultima 

If N is 7 or greater, this statement |s equivalent to "do .ultima". 

The "conditional expression" (N in this case) can*bG anything: it; 
can be as complicated as "3x - 5 sqrt(N)" and can even involve assignments 
as in "N<}=35-x". The value of the expression is rounded to tjie , nearest 
integer before choosing a unit from the list of units? and if the rounded 
value is negative, the first unit in the list is chosen, for example, 
if the expression is -.4, it rounds to zero, in which case the second unit 
in the list is chosen. > 

In a conditional -do— each unit named may irlvolve the passing *of 
arguments: * ' 

do 3N-4,circ (25,75) ,box(45) ,x, flag, circ (1^,3^) 

neg 0 ^ 2 53 

So far we have encountered the following sequencing commands: -do-, 
-jump-, -next-, -nextl-, -back-, -backl-, -help-, -helpl-, -^ab-., -lobl-, 
-nextnow-, -data-, -datal-, and -base-. When the tag of such a command is 
just a singly unit name (e^g., in- a statement like "help uhelper") , we 
say it is "unconditional". To make a "conditional" statement out of -any of 
these, we follow the same rule — state the conditional expression followed 
by a list of unit names. So we might have . . * 

data N- 5 , zonk , q , zap , zing , x ^ 
(y ^ -C* M X 
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Here "q" has the same meaning it. had in unconditional pointet-associated 
stcitoments: the "data" pointei: iis cleared so that the DATA key is disabled. 
This can be used to cancel the effect of an earlier -data- command in this 
main unit. Remember that all the unit pointers are cleared when we start 
a new. main unit.) The i#lilt name "x" has the special meaning "don't do 
anything!" In the examplja shown, if the condition (N-5) is three or greater, 
this -data- command has rib effect at all: we "fall thorough" to the next 
statement without affecting the "data" pointer * Similarly, if a unit name in 
the conditional -do- dis^Cussed eibove is replaced by "x**^^ no unit will be 
/lone for th(? corresponc^ing condition: we "fall through ",v|:o the next state- 
ment. - 

This "x" option is extraordinarily useful. Consider the foll'owing 
situation: 

jump corroct-5,x,dono 

(then show the next item) 

l€ (cbrrectTS) is negative (i.e., the student has made fewer than 5 correct 
answers), wo "fall through" to the presentation of the next item. If, hov/over 
ho has. 5 or more correct, the condition (correct-5) will be zero or greater 
and we jump to unit "done". 



Logical expressions 



The last , example can be written in' an tilternativo form which impr^oveB\^ 
the readability: 

jump correct<5 ,x,dono 

This says "fall through if correct is loss than 5, otherwise jump to done". 
The condition (corroct<5) wo call a "logical expression" "because it has only 
two possible values, "true" (-1) or "false" {0f , whereas numerical e^cprossions 
can have any numerical value. Since a loq^cal expression can have only two" . 
values (-1 if true or J3 if false) it, is pointless to list- more than two unit 
ncimos after the condition.' 

Actually, because of rounding, the form "jump N<5,x,done" is more 
precise than the form "jump N-5, x, done". Suppose that'N is 4.8. Then. 
"N<5" is true (-1), which rounds to -1,, which implies "^". But N-5" is 
-iJ.2, which rounds to zero, which implies "done". Such differences show 
up whenever some of the variables need not have integer values. 

Hero is another example: 

do c-b, far, near , far ^ 



will do unit "near" if c and b differ by no more than 0.5, since in that 
case "c-b" will lie between -jj. 5 and +iJ.5, which rounds to zero. 



VI - '4 ' 



0(1 the other hand 

do c=b,sainG,dif f 

will do unit "same" only if c and b are equal, not just nearly the same-. 
The condition "c=b" is true (-1) only if c is precisely equal to b. 

There are six basic logical operators: j^, <, >f and ^, which 

mean equal, not equal, less than, greater than, less than or equal, and 
greater than or equal. "do * a^b,dif f , same" is equivalent to 
"do a=t),same,diff". The operators involving equality f=, ^, and ^) 

consider two numbers to 'be equal if they differ by ^qsq than one part in 
^0^^ (relative tolerance) or by an absolute difference of 10*"^, whichever 
is larger. This is done to compensate for Small roundoff errors inherent to 
computers due to their very high but not infinite precision. One consequence 
is that all numbers within of 2orO are 'considered equal by these logical 

operators. 

^ ^ . / 

You can mix logical expressions with nVunerical expressions in Tiruitful 

ways : 

if 

calc x<1^1JZlJJ-25(y>13) 

gives ''x^'^^25" if y is greater than 13 ("y>13" if true is -1) or it gives 
"x<^^0ji" if y is less than or equal to 13 ("y>13" if false is 0) . To 
clarify this, suppose that y is 18 or y is 4: 

y-18 . ^ ^ 



100-25 (y>1 3) 100-25 (y>1 3) J 

100-25 (1B> 13) 100-25 (4> 13) ^ 

100-25 (-1) 100-25(0) 

100+25 100- (0) 

•125 100 . ' 

In these applications it would be nice if "true" yere +1 rather thkn -1, 
but the much more common use of logical expressions in conditional branching 
commands dictates the c*hoice of -1, since the first ^nit listed is chosen , 
if the condition is negative. 

* * ♦ 

You can combine logical expressions: 

^ [ (3<b) $and$ (b<5)] : ' 

is true (-1) only if both conditions (^<b) and (b<5) are true. In other 
words, b must lie between 3 and 5 for this ex:pression to have the value -1. 
Similarly, 



(y>x) $or$ (b^2) . ^ 

will be true if either (y>x) is true or (b=^2) is true (or both are true). 
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V 

Finally, you can "invert" the truth of an^expfession: 
' not(b=3c) 

IS true i'f (b-3c) is not true. iPhis completet^ expression ig equivalent to 

y ' ' 

The combining operations $and$, $or$, and "not" make Gense only when 
used in association with logical expreoDions (which are -1 or 0) . For 
instance, [b>c $and$ 19] is meaningless ^ai^d will give unpredictafble resulta. 
(If you have done a great ^eal of programming, you might wonder about % 
qpecial bit manipulations, but there are separate operators for maskihg,, 
union, and shift operations, as discussed in chapter IX.) 



The conditional ^-write- command (-writec-) 



, A very common situation is that of needing to write one of several 
possible message!^ on tho sereer/T For example, you might, like to pick one 
of five congratulatory messages ♦ to write after receiving a correct resjponso 
from the studant: 



unit 
•^r^randu 
y at 

do 

unit 
write 

unit 
write 

unit 
write 

unit 
v;rit(i 

unit 
write 



congrat 
N,5 
121^ 

N-2,okl ,ok2,ok3,ok4,ok5 

okl 
Good I 

ok2 

Excel Ion tl 
ok3 

I*m profld of you. 



ok4 

Hurray I 

ok 5 
Groat I 



loj^ TUTOR pick an integer from 1 to 5 



'The -randu- command, "random on a uniform distribution", tello 'l^UTOR to pick 
jm integer between 1 and 5 and put it in„N. We theft use this value o£ U 
to do one of five units to write one of , five messages. *^'here ic ^a much 
more comj)act way of v;riting this: » 

• /. - ^ • A ■ * • 

unit eongrat 

randu N,^ • 
at 1211) ' . ^ / 

writec N-2,GoQdI ,EKcellontI , . ' ' ^ 

I'm proud of you. , 

Hurray I , Great 1 , • 



ERIC 
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The ^writec- command is similar to that of a conditional branching command, 
but the listed elements are. pieces of text rather than unit nam^s. Because 
-write- can be used to display any kind of, text (including commas), \it..is • .-f 
necessary to use a different command name (-writec-) to indicatl^ the condi-' 
tional form of -write-, whereas in "branching statements the conoftas /separating 
trie unit names are enough to tell TUTOR that it is a conditional rath^ 
urijConditional form. ' . " • ' > . , 

You can write whole paragraphs with nice left margins', just^ as with 
-write- command f "> 

writ^p N, , ,Good! ,Excellentl , ' • . 

I'm proud of | ^ ^ 

, . you and so ' 

is your mother., . * ^ 

Hurray! ,(!5reat! , . 

The elements of text are -set-off by commas.^ If N is'^3, the student will 
see. a three-line paragraph, since there are no comma's at the end of "of" 
and. "so", if N is -1 or no text will be displayed, since, there is no 
text between the first few commas. Note that "x" is not the f all-.through 
that is for a unil/ name in a conditional branching command: here "x" is 
a legitimate piece of text which can be displayed, so the ",,'" form is 
the "fall- through". * , ^ 

,If you want commas to 'appear in some of your text elements, you- have 

a problem, since the commas delimit elements: 

f ■ 

.4 

writec N, Hello!, How are you, Bill?,.Hi there!, 

J. • ^ 

If N is zero, we -will see "How are you", not "HoV are you, Bill?" *The s^olutidn 

is to use a special character (i) : ^ 

'writec NtHello!tHow are you, Bill?*Hi there!i. 

Now if N=jJ we will see "How are you. Bill?". While tlhis special character 
(^y i^ required if text elements contain commas, you may prefer to use it / 
always, even when, there *are no commas. . "* / 

The same kinds of embeddii^ of other^-eommands permitted by — write- 
are permitted with -writec-: y , ' . ■ 

- writec 2c=b,I have <s,ap]> apples., 

I will buy <(s,peachy> peaches., 

^ ' *• ' • • ' ^ * 

The '-writec- is affe&ted by -size- a4:ui -rotate-j commands, just like -write-. 
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The conditional '-calc- commands! -calcc- a^d -calcs- 

The effects of -writec- can be achieved by a conditional -do-; and a 
bunch of units containing the tex£ elements, but we have seen that this is 
a clumsy way to do it. We would often ^like to calculate one of several 
things based on a condition. This, too, could be done with a conditional 
-do- to one of several units containing the calculations, but -this is cximber 
some. We" saw one shortcut already: . ' «> . 

. •<» . • 

<?alc x<Mj^-25(y>13) ' , v / ' 

is equivalent 'to "x<^=125"" if y>13 and to "x<^ljjjj" if^not.' This can also 
be written as ' , 

calcc y>13,xv^l25,x<=ljj^ ' . . # 

The -calcc- is strictly analogous to -writec-. It indicates a list of 
calct)ilations to be performed, dependent on a condition. ' The elements in 
the list are calculations rather than pieces of text or unit names. 

* . Very often each of the calculations . in the list consists of assigning 
a value to the same variable^ In the example above both calculations assign 
a value to the variable ^"x" . An even shorter way to write this kind of 
thing is / * • 

J 

calcs * N-5y,bin<^=37,5.2',y*^+2, ,2/N 

This will §tore (-calc|-) one of five values in "bin" depending on the ^ 
conditipn "N-5y". "Note that if "N-5y" rounds to two, we -do nothing: two 
commas in a row (,,) indicate "do nothing" in -calcs-, -calcc-, and -writec- 



The conditional -mode- command 

I , V J 

For completeness it should be mentioned that the -mode- command also 
can be made conditional: 

mode count-3,write,x, rewrite, erase, write 

Here the list of elements folfowing the condition is similar to the list of 
unit names in a -help- command: they ^re the names of the various possible 
screen display modes. The "x" option means "do nothing — do not change 
the present mode"! ^ ./ ^ 



The -goto- command ^ ^ 

/ ^ 

The -goto- command is a very mild versit)n of the -jump- command. It 
does not initiate a new main unit and does not perform the, initializations 
associated with starting a main uni-^: the screen is /fiot erased, the help' 
and other unit pointers are not cleared, and hov/ deejz^ we are/^in "do" levels 
is unaffected. It is most often use'd in^ its conditional form so we waited 

until this chapter to introduce it. ' ^ / 

/■ 

/ 
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One common use of the -goto- command is to "cutoff" ^ unit prematurely: 



unit 
at 



'CI 



1315 

write You have now finished the quiz, 

goto scoreOO , fair , x 

size 4 

at '22)J5 

write Congratulations I 

size 0 

* 

unit B 

at . 1912 ' 

write The next topic is . . . ^ . 



unit 
at 



fair 
1815 



/ 



write Your score wa^ below 90, 

* / 

unit blah j 



In this example a score -of 90 or better will mean that we fall through the 
-goto- to display the iarge-size "Congratulations!" A score of less than 
90 will take us to unit "fair" to add "Your score was below SJ^'^'^to the 
"You have 'finished the quiz" already on the screei?. The -goto- does not 
erase the screen, nor does it change the fact that the main unit is still 
,"A". When^the studeijjf presses NiSXT, he proceeds to unit "B", the main unit 
fbllowiftig unit "A". He does not proceed to unit "blah".. 

Like -do-, the -gato- command attaches a unit without changing which 
unit is "home", whereas -jump- changes the main unit and performs the many 
initializations associated with entering a new main unit (full-sqreen erase, 
clearing the help pointers', forgetting any -do-s, etc.) As to the difference 
JDetween -goto- and -do-, the main difference is that the -do- will normally 
come back •upon completion of the attached unit, whereas -goto- does not come 
back: statements following the -goto- are normally not executed. 
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The relationships among main units and attached units and among -jump-, 
-goto-, and -do- may be clearer if you think of a lesson as being made up 
of a number of nodes or clusters ^ach consisting of a main unit and its * 
attached units: 



jK3 r,:^^ i. 



-1 t .it Iti- I-.- . ■ t - . tut 



V riv T 



r 



Movement' between main units is made by pressing NEXT (or HELP, _BACK, etc.) 
or by executing a -jump-. These main units may form a normal sequence br 
a help sequence (see Chapter V) . The -goto- and -do- commands "attach 
aiaxiliary units to these main units. 
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Notice that completioh of a unit reached by one or more -goto-s will * 
cause* TUTOR to "imdo" one level if one or more --do-s had intervened in 
reaching this unit. The reason this occurs is that whenever TU'^OR' (Encounters 
a -unit- command (which terminates the preceding unit) TUTOR asks "Are 
we at the main-unit level?'^* If . jso, we have completed processing,; if not, 
we must "undo" to the statement immediately ^following the last -do- 
encountered. This point deserves "an example for illustration: 



^ unit 
do 

show 



calcit 

sum 

total 



unit 
calc 
goto 



sum 

total<S=i2f 
addup 



$$ initialize "total" 



unit 



addup 



unit 



other 



$$ a calculatidn of, "total" 



In unit "calcit" we -do- "sumV, which initializes "total" and does a 
-goto- to unit "addup", where some kind of calculation is performed. When 
we run out of work (by encountering a*-unit- command at the end of unit 
"addup"), TUTOjB asks whether there was a -do-. There was a -do-, so 
control pass^ to the statement ^^fdllowing the last -do-, which is 
"show total^. All of this is perfectly reasonable and useful, but it 
should be pointed out that this property of the -goto-, that it preserves . 
the required information to permit "undoing", has an 6dd side-effect. The 
presence of a -goto- in a done unit causes an exception (the only exception) 
to the description of -do- as a text- insertion device. Except for this 
case, the effect of a -do- is equivalent to inserting all the statements 
contained in the done unit in place of the -do- i^tatement. But suppose we 
replace our ^do- with the statements contained in unit "sum". We would 
have: ^ ' 



unit 


calcit 


calc 


total <?=i2f 


goto 


addup 


show 
* 


total 


unit 


addup 


/ 

unit 





sum 
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Now the -goto- ciits off the rest of unit "calcit", and the -show- will 
not be performed, in contrast with the case where we used a -do-». So 
the presence of a -goto- in a done unit/ causes a (useful) exception to 
the text- insertion nature of -do-. * 

Here is a summary of the basic properties of the -goto- command: 

1) -goto- may be used to attach units with none of the. initiali- 
•za'tions associated with -jump-; 

2) statements which follow the -goto- will not be executed 
(like -jump- and unlike -do-); 

3) a -goto- in a done unit does not cut off statements following 
the original -do- statement, which is an exception to the 
normal text-insertion nature of -do-. 

Additional aspects -goto- are discussed in Chapter VII (Judging Student 
Responses) . 



shown in* this ex 




It is often cofewenient to cut off a unit with a -goto- of the form 



tlnit cuts 

goto expression ,x , zonk , empty ,x , empity 
write We fell through... 



unit empty 
* 



unit zonk 



Note that unit "empty" has nothing in it but serves merely to have a place 
to go to in order to cut off the end of unit^"cuts". This is such a common 
situation that TUTOR provides an empty unit named "q" (for quit) ; the 
previous -goto- can be written as 



goto f^xpr ession ,x , zonk , q , x , q 

and "goto q" means go to an empty unit. The special meaning of q here 
makes it illegal to have your own unit named "q" , just aslit is not possible 
to name a unit "x" . The use' of "q" in a -goto- statement \3 somewhat dif- 
ferent from the use of "q" in a -help- statement. You wil? recall from 
Chapter V that "help' ,, q" means to quit specifying a help\init (by clearing 
the' -help- pointer). Since "do empty" can be rendered by the equivalent 

"do x", the statement "do ' ^q" (or a conditional form) is given the 

sjbecial interpretation of acting like a "goto q". 
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The -goto^ can be used in association with the -entry- command to skip 
over statements: / 



« calc b<J=j3 

' goto 3f>5,leavit,x 

calc b4=f/2 

^-^:r:> entry leavit 



If 3f is greater than 5, we skip over intervening statements to entry 
"leavit". The gentry- command is equivalent to a special -goto- plus 
a -unit-t . ' " ^ 



{ 



special goto 
unit 



Ifeavit 
leavit 



} equivalent to (entry leavit) 



so< that| unlike a -unit- command, > -entry- does not terminate a unit but 
merely provides a named p^ace to branch to* Its equivalence ta a special 
hidden -goto- followed by a, -unit- command means that an entry is completely 
equivalent to a unit except for not terminating the preceding statements. 
For this reason it is possible to use an erttry name with -do-, -jump-, 
-help-> etc. 

The conditional -goto- is often -used for repetitive operations similar 
to those carried 'out with -do-. Here are two versions of a subroutine to 
add the cubes of the first ten integers: 



-do-- 




-goto- 




unit 


add 


unit ' 


add 


calc 


total cJ^JJ 


calc 


i<4:=1 


do 


add2,i-!::^l ,1J0 




total<t=j3 


* 




goto 


add 2 

• 


unit 


add2 


* 




calp 


total<3=total+i3 


unit 


add2 




'* 


^alc 


total <?=total+i3 








i<Pi+l 






goto 


i5llj3,add2,x 
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The last two statjements in the -goto- example could be combined into one: 
goto (i<j=i+1 ):^(lj3>add2,x. For the simple task of adding^ ten numbers, the 
-do- form is certainly easier t6 construct, but situations occasionally 
arise where it is easier to construct a repetitive loop using a conditional 
-•goto- . 

Except for not changing how many levels deep in -do-s we are, -goto- 
is quite similar- to -do-. Although the feature is ^little used, it is even 
possibie to pass arguments to a subroutine with a -goto-: ^ 
"goto z;onk(12j25) Arguments may also be passed in a conditional -goto-: 
"goto 3N-4, alpha (2+count) ,x,beta (1 5 , 2N) ,q". 

f 

The conditional iterative -do- 

The conditional and iterative -do- can be combined so that,' on each 
iteration, the conditioncil expression selects which unit to do this time: 

a. 

do N+3,ua,ub,uc,udji<>=1 , 12 

nog 1 ^2 # ^ 

For each value of i (from 1 to -12), the expression "N+3" is evaluated, 
v;hich determines which subroutine will be done. For example, if "N+3" is 
^f, the above statement is equivalent to "do ' ub, i <?=1 , 1 2" . Usually a 
conditional iterative -do- is used in situations where the conditional ' 
expression ("N+3") is not changing, but doing one of the subroutines can 
change N so that a different subroutine is used on the next iteration. A 
more straightforward example of such manipulations is this: 

'do « i-2 ,ua>ub,uc,ud, i ^1 , 4 

For i'Lc*<|tial to 1, the condition "i-2" is -1, sO we do "ua" . Then i is 
incrfjmonted to 2, and we do "ub" , etc. This statement is, therefore, * 
oquival<»nt to the Jiequence , 

do ua * . 

do ub ' 

do uc ^ I 

do ud * 

As uoual, the specif iipel units can involve the passinq of arguments. 

In a conditional non-iterative -do- the unit names "x" and "q" mean 
"don't do anything" and "jgoto q" respectively. In a conditional itera'tive 
-do- "x" m(?an3 "don't do anything on this iteration", and "q" means "quit 
doing thiLj statement and go on to the next statement". In other words. 



^ VI - 14 



"x" means "fall through to the next iteration", while "q" means "fall 
through to the next TUTOR statement". For example, 

do i-2,ua,x,q,ud,i<3=1 ,4 

show i 

will display the number "3". For i equal to 1 we do "ua"; for i equal 
2 we do nothing? for i equal ^to 3 we quit and go on to the following 
-show-* statement. 
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VII. Judging student responses 



You now cHnow-» quite a bit about how to-'exjjress in the TUTOR language 
your instructions to PLATi^. on how\to administer a lesson to a student. You 
may not have realized* i\:, buS in the process you have learned a great deal 
about the fundamental concepts of 'tomputer programming. You can calculate, 
produce complex displays, and constjpuct rich branching structures.' You 
have studied aspects of initialization problems, seerf the importance of sub- 
routines, and looked at some stylistic aspects of good programming practice 
such as- defining variables, placing unit pointer commands at the head of 
main units, etc. With this solid background you are now ready to see in 
detail how to accept and judge student responses. 

In chapter I you d^w a oomition type"lpf judging situation in which you 
simply list the anticipated responses aftelr.an -arrow- statement, together 
with the display or other actions to be performed corresp9nding to the par- 
ticular response. Let us see how TUTOR actually processes these judging 
commands. We will consider a olightly different version of the "^feometry" 
unit: 



unit 


geometry 


draw 


51JJ;151JJ;154JJ;51J3 


arrow 


2JJ15 


at 


1812 


write 


What is this figure? 


answer 


<it,io,a> si[right,rt) triangle 


write 


Exactly right 1 


wrong 


<it,io,a> square 


write 


Count the 'q ideal 




The order of the initial otatemento hao been changed olightly. TUTOR otarto 
executing thio main unit by drawing the triangle. TUTOR next encQuntera thef 
•*^arrow- .command, placoo an arrowhead at pooition 20^5, and notes where this 
-arroy- command ia (the second command in unit "geometry"). TUTOR then 
exScutea the -at- and -write- to dioplay the text: "What io thio figure?" 



Finally, TUTOR roacheo 'the -answer- command. This "judging" command is 
GcleaD at this time bocauoo the otudont hao not entered a rcoponocl There 



is nothing more that can bo done but wait for the otudont to typo a rooponoo 
and enter it by proooing NEXT. Wo call commando which operate on the otudont' 
responoG "judging" commando (ouch ao -anowor- and -wrong-). Other commando, 
such as -draw-, -at-, -write-, and -ealc-, are called "regular" commandtj. 
We see that J^TOR muot otop executing regular commando when a judging command 
-is encountcired. (Thio aooumeo the prooonco of an -arrow- command: an -anower 
or other judging ^command without a preceding -arrow- io moaninglooo. ) 

When the student prooooo NEXT to enter hio respon so, TUTOR looko at ito 
noteo and findo that tfto -arrow-^ wao th^ oocond command in unit "geometry". 
TUTOR otarto juot beyond there IdoJcing'for judging commando to proeooo the 
otudent'o reoj^dnoo. It okipo the regular llcomnlando -at- and -write-; theoo 
are not judging commando and are of no^\ioo at thio point. It eneountoro the 
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-answer- command and compares the student response with the specifications 
given in the tag of the -answer- command. 

If there is not an adequate match, TUTQR goes ^to the next command looking, 
foi^ a judging command that might yield a match. ' In this case the following 
command is a regular command (-write-) which is skipped. Next ther^ is a 
-wrong- judging command, and if there is no match to the student's response, 
TUTOR' keeps judging. Then comes a -write- regular command which is skipped; 

Filially we come to the end of the unit without finding a matching judg- 
ing command and must give a "no" judgment to this response (and possibly 
mark up the response with underlining and X's if the response is fairly 
close to that specified by the -answer- command). The process of starting 
from just after the -arrow- in the "judging state" will be repeated ekch^ 
time the student tries again with a revise* response. / 

If, on the other hand, the response adequately matches the -answer- 
statement, TUTOR has found a match and c^n temylnate the execution of judging 
commands. It 'switches to processing regular commands with the result that 
the '^fol lowing "write Exactly right i" will be executed. (This regulaf 
.command is skipped unless a match to the* -answer- flips TUTOR out of the 
"judging state" into the "regular state".) Then TUTOR, in the regular state , 
comes to a judging command (-wrong-) which terminates the procesi;ing. TUTOR 
finishes up by placing an "ok" beside the student response. {Similarly, 
a match to the -wrong- would flip TUTOR to the regular state J;©^xeaute the 
regular statement "write Count the sidesl") ^ ^ 

VJhen the -arrow- is finally "satisfied", by an "ok" judgment, TUTOR 
returns one last time to the -arrow- and sear9hes for any other -arrow- 
commands in the unit. In this search it skips both regular and judging 
commando. In our particular example no other -arrow- is found, so all arrows 
(one,|) in the unit' have been satisfied. After the student has read our 
comment to him he presscG NEXT and proceeds to the next main unit. 

It may soom v/asteful to you that TUTOR keeps going back to the -arrow- 
only to skip over the regular commands preceding the fir^l judging command. 
It turno out that okipping a command is an extremely fast procedure and 
that keeping a oingle marker (the location of the -arrow- command within 
tho unit) qroatly ^mplifioo the TUTOR machinery. 

4 

In the example, the replieo "Exactly rightl" or "Count the sidea.l " 
would bo dinplayed at the location 2317, three lines below the response on 
the acroen. This standard poaitioning can, of course, be altered by an 
-at- statement. 
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Here is another illustrative example. You can watch a step-by-step 
animation of the processing of the follo\^ing unit by studying the "simulation" 
t^pic available through lessen "aids" on a PLATO terminal. The unit is: 



unit 


canine 


at 


21jJ5 


write 


Name a canine: 


arrow 


2308 


answer 


dog . 


write 


A house pet. 


answer 


wolf 


write 


A wild one I 


wrong 


cat 


write 


Ji feline! 



Suppose the student enters "wolf" as his rospohse. TUTOR initiates the 
"judginip state" just after the -arrpw-. The firsj£ -answer- (dog) does not 
match, so TUTOR stays in the judging state and skips the "write A house pet. 
There is a match to the following "answer wolf", so judging terminates ^nd 
the regular state starts. The "write 'A wild one!" is executed, not 'skipped. 
Next TUTOR encounters a _" wrong cat", and since -wrong- is a judging command, 
this terminates the regular state. The student gets an "ok" judgment. The • 
search for another -arrow- dpos not find one,. so the student has successfully 
.completed the unit. Study the simulation in lesison "aids". x 

This method of processing judging and regular commands yields a readable 
programming structure, with judging commands delimiting the regular commands 
used to respond to €hQ student. We have ^pont time discussing the detail^ 
in order to simplify our later descriptions of the various >types of judging 
commands u^ed to. match, modify, or store student responses. > 

It is important to point out in connection with those matters that the 
-do- and -goto- commands are regular commands. They are, therefore, skipped 
over during the judging "State and during* the search state (looking for a 
possible additional -arrow- after an arrow has been satisf ie\3. ) . There 
is another command, -join-, which works like -do- except that the -join- 
command is universally executed whether TUTOR is in the regulVar state, 
the judging state, or the search state. It is, therefore, possible to -join- 
units containing judging commando or oven containing additional -arrow- 
commands, whereas a. -goto- or -do- is incapable of accosoing other units 
in thd judging or search states since these regular commands are skipped. 
Although the -^do- command acts essentially liJjo a -join-, it is, neverthe^leas , 
a regular command and is skipped during the judging and search states. Only 
the -joinr- command itself has the unique characteristic of being performed 
in all states — regular, judging, and search. 
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It is frequently useful to handle more than one response in a unit. 
Let's ask "Who owned Mount Vernon?", and after receiving a correct response 
ask in what state it is located but stay on the same page; 



" unit 


wash 


at 


812 


write 


Who lived at Mdunt Vernon? 


arrow 


1 ^11 5 


' answer 


<George,G> Washington , 


at 


112j8 


write 


Great I ' 

Jef f er son ff , 


■ wrong 


at 


1112 / 


write 


No, he lived at J^nticel^o* 


arrow 


1715 


at 


1512 / 


- v)rrite 


In what^state^s it located? 


answer 


(Va,Virginia)# 



If you say "Jefferson" the -wrong- is matched. Regular commands are executed 
until you run into the second -arrow-, which ends the range of .the first 
-arrow-. In other words, when you are working on one -arrow-* the next -arrow- 
is a tenflinating mlirker. if you say "Washington", the student gets the % 
"G^eatl" comment. .Since the -arrow- is'now satisfied, 'ytJTOR starts' at the 
first -arrow- searching for another -arrow-. In "this search state all 
commands other than -joiri- are skippo4 (-join-' may be used to i^ttach ar unit 
that contains another -arrow-). A second -arilow^ is encountered, which 
changes the search state into the regular s,tate. The arrowhead is dis- 
played on the screen and the location of this -arrow- within the unit is 
noted. The regular commands following this second -narrow- are processed to 
display the second question. The finaj. -answer- command stops this' proce^ssing 
to await the student's response. 

There is another way to dp this which is probably more readable: 



unit 
next 
at 

write 
arrow 
/^answer 

) wirite 
^ wrong 
at 

write 



wash 
wash 
812 

VTho lived at Mount Vornon? 
1J315 

<Goorgo,G> Washington 
112J3 
Great! 
Jefferson 
1112 

No, he lived at Monticello. 

r.ondarrow 

at 1S12 \ • 

write In wha% state is^ it located? 
arrow 1715 
{ answer (Va, Virginia) 
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The -endarrow-' command defines the end of commando associated* with the 
first -arrow-/ Note that -endarrow- changed the search state to regular 
state. One benefit of thi^ form is that the secoM arrowhead' appears on 
the screen after the text of the second question, which often spems more 
^atural. • 

It may seem rather* abrupt that the "Great I" and "in what state io^lt , 
located?" both appear on the screen at the same time. It might be bettor to 
let tte student digest the reply before presenting the second quest^ion. We 
might insert a -pause- with no tag just after the -endarrow-. Now TUTOR 
waits for you to press a key, to signal you want to go on, before presenting 
the next question* 

-rj - - ~ " - ' ' ■ 

The -endarrow- command is *quite useful even in units Which contain^ 

only one -arrow-^ 

• ' ' ' / • 



arrow 


1213 


answer 


dog 


write 


Bowwow 1 


answer 


wolf 


write^ 


Howl 1 


wrong 


eat 


.write 


Meow. 


>.endarrow 


calc 


y <^37+y 


circle 


i;jja,25;jU3^J 



' / 

The 'commando following the -endarrow- will be executed only after the -arrow- • 
is satisfied, whether by the response ' "dog" or "wolf". So this is a' convenient 
way to finitjh up the unit. 

While it is possible to -join- or oven -do- units which contain -arrow- 
commands, two seemingly arbitrary rules must be followed or you will get un- 
predictable results; 

^ \ * V ' ' ' 

1) A unit attached by -join- or -do- which contains one or 
, jiQre -arrow- commands' must end with an •-ondarrow- command 
(possibly followed by rogninr commands) , 
* 2) TJhifl attached unit must not contain any -goto- commands. 

If you violate either, of these ruleb, strange things will happen boeaus^ 
TUTOR may "undo", from this unit several times (during judging, v/hilo 
processing regular commands, or in search state). If you follow these two / 
rules the -join- or -do- will act like a text-insertion device: your program 
will act as though you had inserted the attachf^d unit where'' the -join- or 
-do- v;as. Wo will dis^u»s tho^^e rules in more detail later in' this ehaptoi:. 
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student specification of nmnerical parameters 



The -answei;- and ^)i^rrong- commands make it easy to specify a list of 
anticipated responses each of which, due to the 'specif ication 6f synonymous 
and optional words, can allow the student considerable latitude in-the way 
he phrases his response\ In some cases there can'' be no list of anticipated 
jresponsfis _and^ a differen t tec hn ique must b e us ed, ^ For example, „^oia might 
ask the student to specify a rocket's launch velocit^^ and use hig number to 
calculate and display tKe rocket's orbit. ^ Or you might ask Jiim for his name 
for later use in personalized messages such as "Bill, you should look at 
Chapter S." In such cases all you dan anticipate lis that the response will 
be a number or ^ name, but you^ can't, possibly l^st all possible number^ |)r ^ 
names! 



Here is an example of such a situation. We' will pro'^ide the student^ 
with a desk calculator a:ccessible on the »DATA ke>5,. In. the desk «alc\>lator 
mode he can type complicated expressions (such as " receive tte 
evaluated result. , . 4 ' ^ ' 



unit mainline 

datgi ^ desk 

at V " ^l^2jS ' 

write Pres9 DATA for calculator 



unit 
.next 
at 

write 



./:• 



$$ for repeated use 



arrow 
store 
ok 

write 



de'^k 
desk 
1713 

Type an expression. 
Press - BACK rwhen ?f ihished . 
1915 ^ ^ ' 

eval 



r 



$$ Be sure to* define, "eval". -' 
$$ Accept all responses. ' 
The result is <^s,eval)> . *, 

The- 7store- command will evalu^|e *^he student ' s .expression (e.g. "1 34in30/^ " jN 
and store the result in "eval"*n^n this case, the* number 6.5). The -store- 
command is a judging command because it ^erat^s on the student's response 
and can be executed oxily after the student, initiates judging by pressing * 
rqEXT. The -ok- 'command is a universal -answer- whirch ijiatches all responses: 
it unconditionally flips TUTOR Ifrom the judging state to ^th^ regular st^te. 
In this example it accepts any Response and<^nables the following -write^ 
display |:he evaluated result. 

■ .1 • ■ , , 4. ' * . 1^, ^' ' ' * 
, Note gthat a sti^dent need riot use pa:reitth&ses with functions: sqrt25, 

cos60*^, arctanS aref,all legal, jsuch expressions are' illegal "^41 a -dale-. 

a moment' we'll see another way ih wh^h TUTCfe is more tblerarh: o:^ stu£ 

th^n of authors. < 
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What if the response cfennot ^be evaluated, such .as "(-3)''/2" or "19/" 
or "(3+5)))"? The student will get a ^'rio" judgment. To see how this works, 
let's insert a -write- statement after the ^store-: 



store/ eval 

writ^ Cannot evaluate! 
bk 



Notice that this new -write- is normally skipped because the -^tore- leaves 
us in* tfife jt^dging state. But ^ if the student's expression cannot be evaluated, 
-store- makes a "no" judgment "and switches us frqm the judging state to the 
regular state. Then TUTORr executes the "write Cannot evaluate!", after 
which it encounters a judging cToramand (-ok-) which stops the regular, processing. 
Note that -store- terminates* judging onyLy on ^n error 'condition, whereas 
-^answer- terminates judging only on a rpatph, and -ok- always terminates . 
judging. ► ° ' / 

^ ' ■ ■ - / 

You can tell the student precisely what is y^onq with his expression by 
use of the system variable ''formok". This varialile is ^1 if the student's 
expression can be evaluated /^but takes* one of several positive integral values 
for specific erroi;s such as unba^nced parenthes^^$5^bad form unrecognized 
variable name, etc. The variably "formok" is defined automatically t;o per- 
form this function. " ( If you yourself define "formok==y3" .^ou over 
system definition and you won't get these features.) The /partici^lar Values 
assumed by "formok" Cj|n% be obtained through on-line documentation at a PLATO ^ 
terminal. ^ « ' . * 

^ ' - ■ . / 

You pan give the student some storage variables. l/et'*s define a couple • 

of, variables for the student: 

'■ ' ' . "0 ■ 

define s^dent $$ special define set \, •* 

b6b^30,cat=v31 , c 

Place these defiiles ahead of everything else ' in the lesson. Suppose you 
ha^e assigned. -bob'<I=l 8 and cat 0=3. If the student types "2bob" he gets 36. 
Or he can type "bobcat" and get 54, whereas bobcat would be illegal in a 
-calc-, wheiS^ you would ^n'eed bobxcat or^bob(dkt). Only names de:fined 'in 
the set, of ' def initions labeled "student" may pe used by the student in this 
^ay. ^ * Attempted use of natnes in your other sets of defines will give a- value • 
of Vformok" corresponding ' to '*Unrecognize^ -variable najne"; / 

^*We haye-discu$sed'*& desk calctilalior , but , clearly the store/ok combinatibh 
\ilill work iri any situation where wfe—xet the stiident choose a number. Another 

. " = . / T 
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good example is in an index of chapter numbers: 




unit 


table 


o 


base 






term 


index 




at ^ 


1218 




write 


Choose 


a ci^pter: 




' 1) 


Introduction 




2) 


Nouns 




3) 


Pronouns- 




4) 


Verbs 


arrow 


1322 




>long 


1 • 


$$ get one 



jump 
write 



chapter 

chapter , x , x , intro , unoun , pron , verb , x 
Pick a .jiuinb,et between 1 and 4, 



The -long- command following an '-arrow- (but preceding any judging .commands) 
sets a limit cfn the length* of the student's rei^nse. The "long -»^V' \s 
particularly useful here because the student need not press NEXT but has 
only to press th'e eirfgle number .dfi(^ judging starts right away. MFor --long- 
qf greater than 1 there must be an accompanying "foto^ '^long" statement 
or else a NEXT key is required.) The reason -long- mus^ precede ciny judging 
command is that the long specification is needed before the student starts 
typing, whereas we proceed past the judging commcind only after the student 
fejiters a response*. You might think of -long- as a. kipd of modifier of the 
-arrow- command. Thev-arrow- sets a default maximum response length whiclj 
is overridden ?o^lP_^^p9^1"-^^ - - — - _ — 

The -no- in this index unit is similar to -ok- in that it unconditionally 
terminates judging, but it mal^eS a "no"oudgment. If "chapter" is a number 
from 1 to 4, the -jump- will take the student to his 'chos'en chapter,-* since 
-^ump- erafees the screen the "no"^ Will not be seen. .If, however, "chapter" 
is ncft in ^range, we fall l^rough the -jump- to an error message.^ Ther^ will 
b^ a "no". next to the response and the student must try again. 



Student specif icatioi^ of non-numerical parameters 



Having seen how to lei? the student specify a number, let's see how 
ask him to teil us his name or nickname to permit us to speak to*4iim by 
■ ' ^ 

*unit meet ^ ^ 

at 1215 , 

write Hello^ my name is Sam Connor. 
What's your namep 

1620 - |( ' ' 

B $$ limit! to 8 characters 

$$ define "name" earlier 



to 

name: 



arrow 
long 
storea . 
ok 

write 



3^ 

name 



Pleased to meet you, <(a,name> 
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-storea- is a judg^ing con|nand which will store alphabetic information as 

di^stinguished from numeric' information. The <ta,namej> is the embedded 

form of the -statement "showa name" which will^ display alphabetic inf orTna€ion. 

T\iis unit will fe/ed back -to you any ntoe you give i%. Notice that you ca^t 

enter a 'name of more tiian'8 characters - because of the -lohg- command. If 

capitalized, the ^name mu;^t be shorter because a capital letter coun£s as 

two cha'tacters: TUTOR^ stores a capj^tal letter , as a "shift" character plus the 

l6wer.r?<pjfc(3e letter. (Insert a ''" force long" ^^statement anywhere before. the 

-storea- if you would like judging to start upon -hitting the -long- limit, 

without having to press NEXT. ) 

' A statem^t of^ the form "storea name, 3" will store jui^t the first three 
characters of the student's response. You can get and keep a character count 
of the I^engthr of .the student's name, |')icluding "shift" charatrters, by referring 
to the .systemr variable "jcount"-) whiciljt^is a count of the humb^r of characters 
'in the copy of the student response u^ed for judging — hence the "j". With 
these facts in mind, change the -storea-^ to ^- 



storea name, (naming <=j count) \ 

which will store ^e whole response and save the length. Be sure to define 
both "name" aihd "naming", but do not define "j^count" or yo\^ will override 
TUTOR'S definition of its function. Also, change the embedde^d -showa- to 

<a , hame , naming J> 

to show precisely the correct number of characters. 



" T7TieTearsbh~for^^saving^^ the present value of "jcoimt" in "naming" is that 
"4count" will change at each -ar;ro^- in the—lesson, l#iereas throughout the 
lesson you will repeatedly use "showa name, naming" or a, name, naming J> 
tp call the student by name. So you want **namlng" to keep the name J length. ^ 
Incidentally, a -showa- with only a single argument (such as "shov^ name") 
will show ten characters, which is the number of characters (including shift 
character^) that will fit in bne of your variables. 

It is possible to store a^lphabetic information longer than ten characters. 
Change the "long 8" to "long 20". Suppose you've Refined "name=:v24": 
you must make sure that you are not using v25 ,^ and change your defines if 
necessary. The 20-character name will n^ed both v24 and v25 since each variajDl 
can hold only ten characters. With these changes it is, possible tp enter a 
long^ame (e.g., Benjamin Franklin, which is 19 characters counting ..shift 
characters) . ^ 



Dif fejp^nce between| numeric and alphabetic inf ormatiori 



student a variable 



When we were iitadying the desk calculator unlt> we defined for the 

"bob=v3j?". Suppose the student enters a^ his response 



the word "bob". If. we use a numeric -store-, we will get the number 
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presently contained^ in v3j3, which m4ght be 529.3. If we use an alph^etic 

-skorea-, we will just get the string of characters "bob" which is ^simply a 

naime and nothing , more . Perhaps the distinction d^is most easily seen with 
ani example: 





define"^ 


student 
bob==vl 








define 


ours, student 


$ $ include " student " 


set of defines 






name=v2 , nxim^v3 








unit 


test 








nextj 


test 








calc 


bob <J=7T 


$$ TT means 3. 141 59. . 

" 11 






arrow 


1815 






store 


num 








storea 


name 








ok 










write 


num = <Is,num)> 
name = <(a,name 


, jcount.)> 





'Consider various responses. "2bob" should give a numeric. 27T (6.2832) and 
an alphabetic "?bob". More properly, we speak of "alphanumeric" information 
(letters and numbers) in the latter case,. The response "3-4/5" yields a 
numeric 2.2 and an alphanumeric "3-4/5". 

In other words, a storea/showa combination just feeds back exactly the 
alphanumeric text entered by the student. On the other ^and, a -store- 
involves a numerical evaluation of the student ' s* response , and a later ^-show- 
Gonvelrts ,this numerical result into appropriate chara cter s to display on the 
screen so that we can read the result.. You might interchange the "num" 
/and "name" arguments on the -store- and -storea- commands to see what weird 
things happen if you pair -store- with -showa- (instead of -show-) or if- you 
pair -storea- with -show- (instead of -showa-) . 

To sum up, if you accept numeric information with a -store-, display it 
with a -show-. ^If you accept alphanumeric information with a -storea-, 
display it with a -showa-. * . 



More on -answer- and -Wrong- Cincludes -list- and -specs-) ' i 

There arob some additional features of -answer- (and -wrong-) which 
should be pointpd out. First, -answer- will not only handle word or sentence 
responses but will also handle numbers: 

ahswet 7 women <and> 5 men v - . ^ 

This -answer- will b(fe matched by a stufient response of the fojfm ■''14/2 Women 
and 3+2 men" because simple exp|:ession|s such as lj4/2 or 3^2 are evaluated 
by the -answer- command. Currently the -answer- 'command will not handle 
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more complicated numerical expression. (Later we will discuss the -ansv- 
and -wrongv- commands which handle expressions as complicated as those 
handled by -store- but^ without the sentence capabilities of -answer- and 
-wrong-. There are also -ansu- and -wrongu- commands which are similar to 
-ansv- and -wrongv- but treat scientific units on a dimensional basis.) 

•If the student says "37 wonvsn and 5 men", the incorrect number 37 will 
have XXX under it, whereas the response "6.5 women and 5 men" will have the 
6.5 underlined since it is nearly correct (similar to a misspelling of a, 
word). Normally -answer- and -wrong- consider numbers off by less than 10% 
to be "misspelled". YDu can aOlter these specifications by preceding the 
^list of -answer- and' -wrong-*, commands with a -specs- command: / 

f * ■ / / 

unit trial 

arrow ' 191 5 

specs ^oler , nodif f 

answer 7 women <and> 5 men 



-specs- is a judging command — it affects the operation of other judging 
commands which follow it. Here it has been used to specify that a ''tolerance" 
of 1% is permitted and that "no difference will be allowed for under lining^V} 
(normally 1j2(%). Having specified both "toler" and "nodiff", any expressions • 
within 1 % of 7 and 5 will be accepted, but expressions with larger discrepanci*es 
will not be underlined. ^ 

Note. carefully that since -specs- is a judging command, it terminates 
the processing of regular commands. Among other things this moans that a 
-long- command must precede the -specs-, not follow it. If -long- comes after 
-specs-, TUTOR woif' t realize it is supposed to prevent the student from 
entordng a longer response, since it won't have seen the -long- before 
stopping to wait for. the student's response. < 

Here are some other useful applications of -specs-: 

s . . 

specs bumpshif t ,okspoll 

answer the antidisestablishmontarianism doctrine 

This changes student's capital letter^ to small Idttorg, and specifies that 
misspellings are to be considored ok. Note that an -answer- tag should ^not 
contain capital letters if you use "specs bumpshif t" to uncapitalize the 
student's capital letters. % 



, sppcs 
answer 

This says it is o 



will bo an acceptable response 



okextra 
Washington 



1 <i j(i 



c ^o have extra v/ordS; so th|at "It was George^ Washington" 



a- 
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X 



' %specs noorder 
answer apples pears and peaches 



This> specifies that no particular word' order is required. Note tfie absenc 

commas iiy^the -answer- tag: currently such punctuation marks are not 
l^lowed there, hiit all punctuation marks are ignored in the stude^'s resjae^se, 
so (he may use commas. There exists a much less powerful -exact- c^lHcnand as 
well as other techniques fot judging particular punctuation when that is 
necessary. 

specs nookno 
ok 



Here we j^pecify that ncj) "ok" orl "no" be! displayed beside the studi 
response, contrary to the R^nnajL situation. ' 



snt's 



For other -specs- capabilities see reference material described in 
Appendix A. C 



There is another important feature of -specs- in addition to its use 
"in specifying various" options: it marks a place to return to after judging. 
Cons'itier the following unit, ^u do not define the system variable "spell". 



unit 


presi 




at 


1212 




wj^ite 


Name one of the first 


three U.Sv^ presidents ^ 


arrow 


151^ 




specs 


bumpshif t 




at< ^ 


2508 




writec 


spell, No misspellings! 






Underlining indicates 


^ misspelled word. 


answer 


Washington 




write . 


Good old George. 




answer 


adams 


V 


answer ^ 


jef f erson 





/ * Suppose the student types "WASHINGTON". TUTOR starts judging just 
after the -arrow~ and encounters -specs-, a judging command. The tag tells 
TUTOJl to change the, response to "Washington" for ^judging purposes. (Inciden- 
tally, this operation changes, "j count" , the charactei* count of the judging 
copy of the student's response, f rom 20 to ^0 because tha "shift" characters 
are knocked out.) Moreover, TUTOR makes a note that it encountered a rspecs-" 
command as the fourth command' in unit "presi", and this marker will be used 
in a moment. TUTOR Skips the following -at- aAd -writec- because regular 
commands are skipped in 1:he judging state. ^ 
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Next, TUTOR encounters "answer Washington" which matches the student '«s 
(altered) response, and this terminates judging. The succeeding regular 
commands are processed as usual. In this case there^ is only a 
"write Good old George" before we run^^into another judging command 
("answer adams") which stops the processing. 

Well, not quite stops processing. For simplicity we've JLied a little 
up till now! At this point TUTOR asks one last question: "Did I pass a ' 
-specs- command in processing this response?" The answer is yes — at the 
fourth command' in unit "presi". TUTOR nov; processes any regular commands 
following that -specs- marker. In t^is case TUTOR does an "at 25J38*' 
and a -writec- before flinally being stoppecF (really stopped thi§ time) by 



the .first -answer- command. 

' 1 ■) 



f 



' The -writec- ref^s to the systckn variable "spell'* whi^h is true (-1) 
ii>>^Glling i| fine, false(j3) if misspelling has been detected. "spell"' 
is -Vsif tl>ere are no underlined words, but^here may be X'ed wOrds — words 
that ar^S^ompletely different. 

The usef^Uoesjs of the marker^ property of -specsr is that you^an - . 
specify a centr^r>$jlace to put messages and calculations which should be 
done no matter whicrNoudging command is matched. We will see additional 
applicaJ:ions of this usfe^u-l feature of the -specs-. Notice that a , later 
-specs- command wilT^Sverri^is^ an earlier -specs- marker in a manneir analogous 
to the way a later -help- command overrides an earlier setting of the "help^* 
marker. Note too that if no. regular comm^ds follow the -spoca-, TUTOR finds , 
nothing to do when it Apmes t^ere after Ibel^g nearly stopped as described 
above. This was the siliuatid^ in our previous examples such cfs " 



"iioo'knu 



w&ere fej^ore are no regular commands between 




specs- and the -ok-. 



Let us^^ifi^urn for a moment to the -answer- ^dmtnand. We had exrampleo 
involving synonyin^ such as (right, rt) or (Va,Vifgini&%. A convenient 
way to specify syndi^ym liotc which occur frequently in £i'-4eoson is to define 
a -liGt-s 





f f irm , yen , ok , yep , yeah , sure , certainly 



Here "affirm" i^ the title 



of a lint of synonyms; "affi-^cm" i£i nat itoe^lf a 



member of that list.. With 



thiijj definition! whichi should be placed at the 
very beginning of your lesson along with ycjur -define- statement > ydU can, 
write 

\ 

/'^ 'J ■ • 

answer 
wrong 



1? 




t 

ft ' 



. / 
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These are equivalent to ^ 

answer (yes, ok, yep, yeah, smre, certainly) ^ \ 

wrong maybe (yes , ok , yep , yeah , sure , certainly) 

Nete that "answer we affirm" does not imply T^s* list ofsyndnyms, as 

a single important word by ilfSelf does not^ refer "to a list^ You can use the 

list equally well to speci^fy optional wordtsy as in 

answer «affirm» it is - * ^ 

<<affirm>> is equivalent to <yes , ok, yeps, yeah, sure ,certainly> . Note that 
<ti|firm> mersiy refers to the single word "affirm". Double marks are needed, 
to rCj'fer to the list whose titlcuirs "affirm". You caci confine references 
to synonym lists v;ith imM^^nSual .words: 




v;rong usually (definite, (affirm)) ^ " 

answer often <definit<J, <affirm>> * . ^ * ^ 

Anotjher list which might be particularly useful is this one: 

liDt . neg^ite , no, nope, not , never ,huhuh 

h'hiG covers the main capabilities of the -answer- and -wrong-^ commands »^ 
and their aooociated -list-^ tJefinitionn. The -specs- ^command may be used 
to modify how -answQr- works and also servos as a useful,,marker . 'The marker 
function of -spectJ- is not limited, to -answer- but holds, for any judging 
qommands which follov; it, including -ok- and -no-. . ^ 

The -aoswer- (or -wrong-) command can nicely handl'p responses which 
involv(; a.relfitivGly. small votobulary of v;ordG. It is, therefore, adequate 
v/hen the context Ijlmits ^tlia^ diversity of studeiit responses^ i&ch as foreign 
language translation drills v;hero there are only a fev; pormissible translations 
of the sentence and each sych sentience contains a rather small nuiiibW of 
allovjabloj words. The detaiired markup of the response is a particularly 
useful ^cedbdck to the student such^ji drill. 

'jyiq -ansv;or- command is not v;ell suited to a more froo dialog with- 
the student ivhore' the context is broader and whore the voealjulari^ used 
the student may encompass hundreds of words. In Vho^QXt section wo dinguss 
-concept- command' v/hich can cope v;ith more complexity. 

' A ' ' . ' . ' ■ \ 

Building dialogs v;ith -concept- iygn^ -"vocabs- ' ' ' *"^Nv ^"^s 

An eKcell[2nt examplo of a.diLalog is a lesson on qualitative mrganic 
chemistry analj/ois writtea. by P^of. Starjley Smith of the Department of * • 
Chemistry, University of Illinoii3--Ui:banci'. This lessors helps students 
practice their deductive -skills On PIjATO Ibofore perfbrming i^n a laboratory „ 
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the identification of an unknown compound. Prof. Smith has PLATO choose 
at random one of several organic compounds and then invites the student to 
ask experimentally-oriented questions aimed at identifying the unknown. 
Typical questions are "what is the melting point"; "does it dissolve in 
sulfuric acid">?"show me the infrared spectrum" ; "is it soluble in H2O". - 
There are over a hundred such qoncepts important in this simulated laboratory 
situation, and since each concept has many equivalent fonjts drawing upon a 
vocabulary of hundreds of words, the number of ^possible responsjes is astro- 
nomical. How can this be handled? 

y ' " , ^ - 

* Although^ the context isL^ar broader tharithat of a languagb drill, it is 
nevertheless, sufficiently limited to be tractable: No attempt is <made to 
recognize^ arbitrary student responses such as "cook me some apple) pie". 
VJith this quite reasonable re-strictiin the situation can be haiidled by using 

le -vocabs- coininand (analogous to -list-) ^to define a large vocabulary, 
with" appropriate "synonymization" , associated with a list of -concept- 
dommanfls (analogous to -answer-) which express the basic concepts meaningful 
^n the context of this lesson. 

Here is a f^j'agment of the -vocabs- command: 

' ^ vocabs labtest $$ vocabulary must have a name.. 

<is , it , a , does , in , what> 
(color , red , blue , green) 
(v;atur,H20) 
(dioGolvo , soluble ) 



And hero aro a couple of tho many -concept- commands: 

arrov; 1213 
concopt v;hat color 
v/rito It is red. 
con(.'(»ptj;) oolublo - in wator 
^ v;rit(j It'o alicjhtly nolubl(> in water. 



Considnr (what TUTOR dooo withl "concept soluble in water". It knows 
thaty -oon(;ept-! han a tag conoioting of words defined bylja previous -vocabs-, 
(Ao iuGual V7ith| tju<;h mat^tf>r3,-4;he **irocabG- dihould be at rhe beginning of the 
loorion.) Tho first v/ord ipu^tho tag is "soluble" which it finds is the third 
■-i^pOT^ISnt v/ord in the vocabulary, dinnountifig the ignorable or optional wordc 
"iG,it,a" etc., and lumping synonyms together so that "dissolve"^, is also 
considercid a "nlimbor 3" vocabulary word. ilThe next word of the tag is "in" 
V7hifi4i . TUTpH throwa'^;ay because tho -vocal?s- says that word is igrrorable. 




VII - 16 



The next word "water", which is in the, second set of important -vocabs- 
synonyms. The net result is that "concept sofuble in water" is converted 
to the sequence "3 2", ^ 

^oW consider a student in this lesson who types "does it dissolve in 
H^O". Superfically this looks quite different from the -concept- tag 
J* soluble in water!*- But TUTOR encounters «a "concept- coijimand which, uiilikfe 
-•answer-, indicates that the student ' s respons4^ should be looked up, in the 
defined vocabulary (in the case of -answer- there is no one vocabulary set. 
be<5Jai4se each -answer- may include various -list- . references and particulSCr 
words specific to that -answer-,) By a process identical to the conversiCtj 
of the author's -concept- tag, TUTOR converts the student's response into 
"3 2". This' compact form "3 2" does not match the first "concept what colo: 
(which was' cohvqrted to "T") so TUTOR proceeds to th^ next judging qoramand, 
which is "concept soluble in water" or rather its converted form "3 '2", ^ 
This matches, so judgj.ng terminates and regular processing begins. The . ' 
student gets a reply "It's slightly soluble in water.^ " 

t ■ 

Notice that the first -concept- encountered trigger*^ the transf ormatioij 
of the student'^ response into the compact- form suitable "fdr looking through 
a very long list- of concigpts, tf^ the -vocabs- contains an entry such as 
(f ive, 5,cinco)^ the'student may match this entry with'"3+2", just as in an . 
-answer- statement involving numbers. 

You wil^ have to experiment ^ little with this machinery to' learn how ^ 
beat to managed the synonyraization in the vocabulary. This does 4^pend on the 
context. In an art lesson it would be disastrous^ to call --red and blue 
synonym's as was don^ here, but it makes sense in this context where the only^ 
concept related to color has to do v;ith "what color is it", which means 
-essentially the same as "is it red" or "is it blue", 

^ You v;ill find that the iisie of words not defined by -vocabs- will result 
in a markup indicating which woir4^3 are undefined ( 3rau will see^ujiuuu for 
ynknpwn under these words) , If yo"ur context is such that you n^d worry only 
about key words and don't care if tho^ student asks "does it dissolve superbly 
in water", you might precede the first v^oncept- with a "specs okxvocab" 
v/hich says that extra student words not foimd in the vocabulary may be ig- 
nored, as though they had been so specif iedx^ the -voeobs- tag. In tl\at 
case you need not define any ignorable words wi4^ • -»vocaba- , but you would 
write "concept dissolve watgi^' ,' not "concept disso^-ve in water" since extra 
author words are-.not tolerated, If^ you don'jit ."bj^ess okxvocab", the 
student's word "superbly" will be marked j|^)aiiuuuuu)|a ) , If the student misspells 
a vocabulary word, that word will b^ und<s^l;|n(2d : ' agluble in water, > 

Here is an alterrfStive and more deta'alled r$i<5Ti of t;he^ heart of I^He 
dialog lesson, which illustrates sdveral pJmiTti4sl This is a rather complex 
example which brings together many aspects .o^^Tfe.TOE, Note particularly that 
the -concept- statembnto now are listed one fiifster another. The- variable 
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"unknown" is a number from 1 to 4» associated with which compound the student 
is .attempting to identify. The system variable "anscnt**" is set to zero when 
judging starts (and when a -specs- is encountered) arid it counts the number 
of -answer-, -wrong--, -ok-, -no-, and -concept- •commands passed through. 
If the third such command terminates judging, "anscnt" will haye the valu^ 3. 
If no match is founds "^scnt" is set to -1 . 



arrow 1213 
wrong what is it 

write That is for you to determine I 
specs ^ $$ to clear anscr^ again 

goto anscnt>^ , unknown ,x 

writec vocab,I don't understand your sentence.. 
The uuuu words are not in my vocabulary, 
bpncept what color 
concept soluble in water 
concd}3it boiling point , 



unit unknown , 
goto unknown- 2>reply1 ,reply2,reply3,reply4 




^ , unit replyl 

writec anscnt,,,It is colorless.. 

It* is slightly soluble in water.. 
The boiling point is 245-247°' C. , 



^ Thci^ statement "wrong what id^it" is necessary because a 
^'concept what is it" contains dnly ignorable words and would, therefore, not , 
distinguish between "what is it" and "does it what", which also contain 
only ignorable words. Since -spdcs- resets "anocnt" to zero, "anscnt" will 
have tKe value 2 if the ctudont'a reoponQe matches the aecond -conoept- 
1"G^luble in watex")". N» regular commands follow this -concept-, oo TUTOR 
goes right to the -ispecG- marker to execute the regular commands there. 
Since "anscnt" is greater than zero,, TUTOR does a -goto- to unit "unknown", 
where there is a -goto- to' unit "reply 1 " (assuming we are „ working on unknown 
number 1 ),' which writes "It is slightly soluble^^in water" oh tho student's 
screen. , ^ . - . - ^ . ' ' - ' 

This structure makes -it very e^sy to adid ^a -fifth unknown cdrtijpdund to 'the* 
'lesson. The -vocabs- and list of -concept- commands do not haVe to be changed, 
since^ thq. basic concepts and vocabulary are pertinent to the analysis of any 
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compound, All^Chat is nocossary is to add *'reply5" to the end of the con- 
ditional -^oto- in unit "unknown" and to write a unit "replyS" patterned 
after unit "replyl"- All done! 

VThat ^happens if the student says *'it what' does"? This will not m^tch, 
the -wrong- nor any of 'the -concept- commands, so "anscnt" will be -1 • 
Therefore, the -goto- jUst after the -specs- will fall' through to the. following 
-writec-, which gives one of -the two messages dependent 'on the system variable 
"vocab" (true if all words found in vocabulary, false if some words not 
found — those having uuuu underneath them-) In fehis (fese the student will 
getothe message "I don't understand your 1 sentence" , whereas if he ^ays 
"what is elephant" he wili see the uuuu'b under "elephant" and get th^e message 
'"The uuuu words are hot in my vocabulary" • 

That was a fairly complicated example, but the discussion is justified 
by the general usefulness of many of the techniques egaployed and by the 
extraordinary power such a structure yields, both in its sophisticated 
handling of student responses and in t^e ease of expansion to additional 
options . 

suppose the -arrow- is in a unit "analysis". One way to proceed from 
one question to the next would be%o place a "next analysis" in this 
unit. Thei^ is an elegant way to avpid erasing and recreating the display 
.associated wi^h this ujiit. Instead of proceeding, lot's judg^' each rGsponse 
"wrong? ,90 thab we stay at this -arrow-. Replace the -specs-' command v;ith*^ 
these two statements: 



" qpecs nookno $5 so "no" doesn't 'appear 

judge wrong 

Despite its name, -judge- is a regular command, not a judging' command. It 
can be used to alter the judgment m^ade 'by the judging commands, . In this 
case,* TUTOR first, skips over this regular command to get to the -concept- 
commands.* If one of -those matches the student response, TUTOR makes an "ok" 
judgment, but \jpOn going to the -specs- marker TUTOR finds a "judge wrong" 
which overrides the oarlifeer judgment. TUTOJR keeps going, processing regular 
commands, and produces a -message as we have seen before. The "nookno" 
specif lication prejionts a "no" from appearing 6n the screen and the student 
simply sees. our message to him. But the -arrow- hqs not boep satisfied, so 
when .he pressitis^ NEXT, TUTOR erases the response anci Iwaits a new response. 
Efach.time, the student gets a reply to his experime:nt|il ' question, and the c 
"wrong" judgment takes us back to the -arrow-. j 

/ ■ » - ft . ■ 
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This is a good way to manage the screen because only a small portion 
of the display changes: thd surrounding text and figures remain untouched. 
The ''next analysis" re-entry to this sanfe main unit would quickly get 
tiresome because of the x;epetitious replotting of the surrounding material. 

You now should he able\:o use -answer-, -wrong7, and -ifst- in situationo 
where the vocabulary is small and ^concept- and. -vocabs- whore the vocabulary 
is large. You ha^i^e seen how to use -specs- both to specify various judging 
options and to mark a place where post- judging actions can be centralized. 
You have seen one form of the regular -judgb- command: "jfudge wrong", 
overrides an- "ok" judgment made by an -answer- or -concept-. In fdct, while 
^wrong-' is the 'appropriate opposite of^ -answer-, currently the "opposite"' 
of -concept- must "be implemented l^y a '^-concqpt*- follovired by a "judge, wrong" 
sincG there is no "wrong" form of the -concept- command. ^ 

There is a particularity convenient way to make dif f erent^concepts / 
equivalent, |including different word orders:^ « 

• concept dissolve in water » 

water soluble * 

drcsp in water * . . » 



v/rite It*! 



soluble in H2O. 



'*The^"contlnue4" -cbncept- specifies synonymous concepts. If the student's 
respopse matehes any of these three concepts the same' message v;ill bo givep. 
Also, "anscnt". will bo the same no matter, which of thesti makes the match. 

Use of -vbcabs- makes posqiblo the underlining *bf misspelled vocabulary 
words (or their acceptance v;ith a "specs okapell")=, just as with the 
-arfsv/er- cojnmand. Similarly, "specs noorder" can be used to specify 
that no*' particular v;ord order is required. There is a -vocab- pommand which 
permits a lajrger vocabulary at the pric^^ of giving up those spelling and 
order capabilities. The)r>e is an -endings- command which makes it easy to 
expand a vocabulary in terms of Word roots plyis icndings- 



The -judge- command 



l-lo have oncountored the regular command -judge- (not a judging command!) 
and Qoon one use of it to "judge ' v/rong" a response .that had alre„ady if^ceived 
an "ok" jud(|mnnt. The -judge- eommam^ may ^Iso bo uopd to "judge Dk"i a 
ronponse independent of v;hat a^provioS^s jud(|ing command may have had to say. 
/rhoro is a eonditiont^l form.' 

judg*} ^ px-y ,bk,>c,v^ong 



w^ll mako the judgment, "ok" , or nfefe alter the eurr(»nt judgment (the "k." 
option), or „make th^ jud(jmont "v/rcinq" depending on the condition "3x-y". 



0 
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Here is a useful example: 



unit 
at 

write 

arrow 
store 
write 
ok 

judge 
writec 



negative 
1214 

•Give me a 
negative number: 
1516 

num ^ ^ 

Cannot evaluate your expression. 

$$ terminate judging 
ntim<iJ I ok I w^ong 
num<iJ, Good I, That's positive I 



We could just as well write "judge ' num<iJ,*'x, wrong "since the-<iriginal 
judgment was a universal 'pk*. (Later we will study ""ansv- and -wrongv* 
which are also useful in numerical judging.) 

We have been using the -ok- or -no- coiumands to terminate judging 
uncoiTi^itionallyi as in the last e:rtample. It is sometimes useful to be 
able to switch in the other direction, fran the regulau:' state to the 
judging state. For example i suppose you want to count the number of 
attempts the student makes to satisfy the -arrow-: 



calc 
arrow 
ok^ 
calc 
judge 
answer 
etc. 



attempt 
1518 

attemjpt O-attempt-fl 

continue 

cat 



Judging starts just after the -arrow-. The -ok- terminates judging to 
permit executing the regular -c^lc- which increments the ^'attempt" 
counted* Then the regular -judge- command says "continue judging", 
which switches TUTOR back into the judging state to examine the -answer- 
and other judging commands which follow. If the response-48 finally 
judged "no", the student will respond again, aqid since judging starts 
each time from the -arrow-, the "ei^empt" counter will record each try. 



A COMMON MISTAKE is to leave out the -ok- and "judge 
permit counting each attempt. If you write 



continue" which 



calc attempt <J=iJ 

arrow 1518 

calc attempt <^=attempt+ 1. 

answer cat . ' 
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then "attempt'.' will stop at one. TUTOR initializes "attempt" to 0/ then 
encounters th^ -arrow- and notes its position in the unit. Then the following 
-calq- increments "attempt" to 1 1. after which the -answer- judgingi command 
teirminates this regular processing to await the student's response. The 
student then enters his response and TUTOR starts judging. The first command 
after the ••arrow- is the incrementing -calc^i which is skipped because it i? 
a regular command and TUTOR is l<5o&!hg for judging commands. This will 
happerf on each response entry, so "attempt" never gets larger than one.* This 
explain^ the importance of bracketing the -calc- with -ok- and 
"judge continue". 

A related option is "judge rejudge" which is Similar to 
"judge continue". We have seen that "specs bumpshift" alters the "judging 
copy" of the response by knocking out the shift characters. The judging copy 
is the version of the response which is examined by the judging commands 
such as -anawor-. This version may differ from the student's actual response 
duo to various ofjorations such as "specs bumpshift**. It isL/Alsp possible 
to -bump- other characters or to -put- one string 0f charact^s in place 
of another. All such operations affect the judging copy only and do i^jgt^ 
touch the original response , which remains unmodified. The statement 
"judge rq judge" replaces the judging copy of the response ^ith the 
original response, thus cancelling the effects of any previous modifications 
of the judging copy. It also initial^es the system variables assOc±«%%d 
with judging, including "anscnt". It is, therefore, much more drastic thSh 
"judge continue", which merely switches TUTOR to the judging state Without 
affecting the judging copy or the system variables. 

Another exceedingly useful -judge- option is "judge ignore" which 
erases the student's response from the screen and permits hiio to tWe another 
response without first having tt> use NEXT or ^;rASE. Unlike "judge/ wron^", 
"ok", or "continue", "judge ignore" stops all processing and avjaJLts new 
student input. Even the commands following a -specs- won't be par formed. 
On the other hand, TUTOR goes on to thq following compiands after /processing 
-judge- with tags "ok", "wrong", or "continue,". ' 

A good example of the heightened interaction -possible, throv^gh the use> 
of "judge ignore" is the following routine which joermits the student to 
move a cursor on the screen. We use the typpiferiter Keys d,e,w,q,a,^,x, and c, 
which are elusLtered aroui\d a 3 by 3 square "on the keyboard, to indicate the 
eight compass directions for the cursor to move on the screen. Thes4 keys 
have small arrows on them to indicate their common use for mbving a cursor. 
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unit 


cursor 








calc 


X <=!y «a25i3 


$$ 


initialise cuj^sor position 






$$ 


cursor step 


size » 


do 


plot 


$$ 


plot cursor 
don't show 


on screen • /^/^ 


inhibit 


arrow 


$$ 


the arrowhead* 


arrow 


^2f^^ ^ ^ 








long 


1 • 








specs 




%% 


cbme here after judging 


goto 


move 


$$ 


-goto- is. a 


regular conunand 


answer 


d 


$$ 


east: angcnt=1 / 


answer 


e 


$$ 


northeast 


2 


answer 


^ f 


$$ 


north 


3 


answer > 


$$ 


northwest 




^answer - 




$$ 


west 


5 \ ^ • 


answer 




$$ 


southwest 


6 


answer 


X • 


- $$ 


south 


7 


answer 


c. 


/ $$ 


southeast 


8 , 


ignore , 






equiyalent 


to : r no 


it 






V judge ignore 


unit 


move 




g 




* erase 


old cursor 








mode 


erase ' 








do 


plot 








mode 


write . 









♦increment x and y on the basiS of "anscnt" 
c^lc s an sen t- 2 ; X c3=x+dx , x+dx , x , x-dx , x-dx , x-dx , 
• .x,x+dx ' . 
anscnt-2 , y o=y , y+dy , y+dy , y+dy , y , 
y-dy,y-dy,y-dy 

plot . , • 

ignore 

- . • ^ ■ 

plot - 
x,y 
+ 



calcs 
do 

^^^^ judge 



unit 
at 

write 



$$"*use for cursor 



This routine permits the student to move the cursor rapidly in any direction 
on the^screen. A letter which matches one of the -answer- statements* will 
cause ^e -calcs- statements to update x and y appiropriately to move in one-, 
of the eioht compass directions. The "long 1" makes it unnecessary to 
press NEXT? to initiate judging, and the "judge ignore" after the replotting 
' of the cui^^or leaves TUTOR again awaiting a new response. The "judge ' ignore' 
greatly simplifies=.repetitive response handling such* as arises in this example. 
Normally such a cursor-moving routitie woulcUbe associated with ofHions to 
perform some action, such as drawing a line. This makes it possible for 
the\student to draw figures on the screen. 

In addition to the -judge- options discussed above, there is a " * 

!!juidge exit" which throws away the NEXT or timeup key that had initiated 
judging. This leaves the student in a state to type another letter on the 
end of his response. This can be used to achieve special timing and animation 
effects. 
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To summarize i 'the -judge- command is a' regular command used for Control- 
ling various judging aspects. The -ok*-, -no-, and -ignore- are judging 
commands which somewhat parallel the "judge ok", "judge no", and 
"judge ignore" options. The "j^idge rejudge" and "judge contiriud" 
options make it possible to switch fir om the regular state to the judging 
state with or without reinitializing the judging copy of the student response 
and the system variables associated with judging. All of these option^ 
may aj^ear in a conditional -judge-: » 

judge expr,no,x,ok,cont;inue-,wi:ong,rejudge,x,ignore,ok 

I » ^ .0 

-meaning "do nothing". The Subtle d'ifference between "judge wrong 
aif[d "judge no" will be discussed in the chapter on "Student Response Data" 
isically, •* judge wrong" is used to indicate an anticipated specific \ 
rong response, wl;ierfe^s "judge no" indicates an unanticipated student 
/response^ Additional/ -judge- options are "quit", "okquit", and* "noquit'*. 




indjng key words; /the -match- and -storen- commands 



The -match- command, a judging command, makes it easy to look for k^y 
words in a student's response. Not only wiJflTit find^a word in the midst^ of 
a sentence, butv it replaces the .found -word in the ju(Jging copy with spaceb 
to facilitate the further'liSe of additional judging commands, including 
-match-, -to (analyze the remainder of the xesponse. Here is the f orm^ of a 
-match- statement: "^^^ 

match num,dog, (cat, feline) , horse, (pig, hpg, swine) 
0-123 
Here "ngim^ is a variable which ^will be s^t^to -1 if none of the listed words 
appear ^ the student's response, to 0 if "dog" appears, to 1 if "cat" or 
"felinfe" is present, 2 if "horse" is in the response, etc. In any case, 
-match- terminates judging, with a "no" judgment if num^-l or "ok" otherwise. 
Wj>at if more than one of the w^rds appears in. the student's response? Suppos 
the student Says . - • - 

■. . " * ■ 

"horse and dog»" ^ * , ' 

In this case "nam" will be set to 2 because in looking at the first student ' 
word We find a match (horse) , The judging copy of the resj^nse is altered 
by replacing "horse"' with sf>aces so that it looks like. 

" and dog", _ ' , 

If we were to ekecute the same -match- again we would get the number '0 
corresponding to "dogV, and . the judging copy would then look like 

and ' " . 

Note that -match- always terminates Judging, so that a "judge continue" 
is needed before another -match- can be executed. Also note that the Key- 
words are pulled out in the order in which they apjiear in th& student "s re- 
sponse^ not in the order they appear in^^e -match- statement." 
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Now let*s do some useful things 
greatly on our cursor program: \ ^ 



inhibit^ arrow 
arrow 32^f1 / 
long 1 
y^"^ match num,d,e,w,q,a,z,x,c 
' goto num,x,move 
judge ignore 



^ with r -match-. First, >j/e 



can improve 



with unit "move" unchanged . except €o replace (in 'two places^) the expression 
"anscnt-2" by the expression "num-1". We see that -»match~ is useful for 
converting a word to a number which represents- the word's position in a list. 

Another goo'd use of -match- is"^* in an index: 

^ . ' - 

unit table ' . ' ' ' 




arrow/ 
X long^ : 
match 
calc 
jump 
write 



^dex 

12 

Choose 
' a) 
b). 
c) 

1822 
1 

chapter > a, b,c,d 
chapter <«chapter+1 
chapter , x , x , in tr o \ unoun i pr on i 
Pick a>b,c, or d. 



a chapter: 
Introduction 
Nouns 
Pronouns 
Verbs 




vei 



Notice that we must increment "chapter" by one if we want topic "a" to be 
chapti^ 1, sinc^' -match- associates jJ with the^irst element in its list 
(because -1 is res^rvecj for the case where no ma^h is found). If np match 
is found, there is ^"no" judgment, . 

These applications ir^ely scratch the surface af the power available 
rrh — mai-r'h— - H*a<r*a ^ii^^gome Other ideas * - ^ ' 



through -match- 



1) Use -match^ to pull out negation words sucn^ no, not, 

never, etc* "judge >qontinue"!' and use -answeb^ or -concept- 
commands to analyze the Xeniaii|der of- the response. You can , 
in this way separate the basic \5pncept from whether it is 
negated, with the negaliion' information hield in the -match- 
variable for easy use in ^conditionak statements. 
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/ ^- ' ■ . ■ . ^ : ^ • ' , \ ■ . . 

^ 2) -niatch- is useful in identifying and removing a directive 

" before processing the rest of the information, Tl>is comes * # 

up in simulating computer compilers^ in games ("move^^ or 
"capture" such-and-such) > etc. 



h related command is -storen-j which will find a simple numeric expression 
in a sentence J store it in your specified varistble^ and replace the expression 
with spaces. This is particularly useful for pulling out several numbers; / 
—store- will hcindle much more complicated e3q>ressions includ;Lng variables * ^ 
as well as numbers, but can-get only one number. For, example, the studei^t * 
might respond to a question about graph-plotting coordinates with ' 
"32.7,38.3". These two ^[lumbers can be acquired by; ' ^ , 




sorrow 1215 

atoren x ' . " 

write You haven't given me niimbers. 

. ^ storen y ; / ^ ' 

^ write yx>vi only gave me one number • ' 

2u^Qwer $$ remainder should be essentially b)^ank 

no^ t» ' * • 

write ^ere should just be two numbers. 

Like -store-, -storen- will terminate judging on an erroi* condition (that^no 
number was found). In the example, the first -stpren- removes and istores 
one number in "x;" and the second -storen- looks for a reirfainiyig number to ^* 
store in "y". ^ThQ first -storen- will terminate judging if there arev^no - 
numbers — the second -storen- if there is no number remaining after on^ ha!s « 
been removed. The blank -answer- will be matched if only punctuation Sjich 
Ih^^omtnas remain's after the. actions of tlie two^^.- storen- s. / \ 

1 aii^ algebraic judging; -ansv- and -wrongv- ' ' \ 

^ . " . * • \ 

We have 'already had* some experience in handling numerical and algebraid 
iresponses* by using -storte- to evaluate numerical lyj\t;he stUcient's expression. 
The -ansv- (for "answer ife variable") and -wrongv-^ juaging commands evaluate 
t^e student's expression in the same way as, -store- land also perform a 
comparison with a specified 'value. 

. The \ -ansv- command is useful in association with -store-. If you ask 
the student for a chapter number or a launch velocity of a mSon rocket, it 
is convenient jio use ^ansv- to check whether his number is within *the ranges 
you al],ow. For example: ' V • 



arrow 13T4 

store chapter 

ansv 5,4 
no >' ' 



write Choose % chapter from 1 to 9. 
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pother commoiTusd is in arithmetic drills; 



define^ b=sv1 ,c»v2 
unit drill 
next ^ drill 
randu v h,^f^ 



$$ multiplication drill 

$$ pick- an integer from 1 to IjJ 
$$ pick another integer * 



o,^0 
1513 

What is <(s,bj> times <[s,c> ? 
17i5 . 

bxc $$ no tolerance 

Right! \ V. 



orandu 
at . 
write 
'arrow 
ansv 
write 
wrongv b+c 
write You added. 

wrongv bXc,1 $$ plus or'minus 1 

write * You are off by 1 . * . 

' wrongv bxc>2j3% $$ o^r minus 2|l% 

write / You ar^ fairly close. 
tib 

write You are way off I 



The ^i^^ill a^ written will run forever.' It could be modified to stop after 
5 straight , correct responses, or after some other criterion has been met. 
Nate that' the response "Idc" or '^bxc" is judged "no" (unless you define these 
variables in the "student'* set of di$f in^s) . It is, however, humorous that 
the student' need not do any mental multiplication, for if he is asked to 
multiply 7 times 9 he can respond with 7x9, which matches the -ansv*;! 



Let 
student" 



's make a change to recjuire some multiplication on* the part of ^ the 



ansv bxc 

judge open t=jj, ok, wrong 

writec opcnt=iJ, Right! , Multiply! 

wrongv b+c 



Dp not define "opcnt": ' it is a system variable which counts t!he number of . 
d^jerations in the student's response* If the student^ says "7(5+8+3)/2" 
then "opcnt" will be 4 because there are • " ^ ' . 

* 'i^^ . . - 

1 ) an (implied) multiplication (7 times a parenthesized expression); 

2) two additions; 9 * 
3> a division. 

*• ' ■ ■ ' • *' ■ . 

In this drill we want the student to give the result with no operations, 
so "opcnt" should be zero. ("specs noops,novars^' can also be used to " 
prevent the student from using operations or variables in his response.) 
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Recall that the first -^concept- command encountered will trigger the 
reduction of the student's response to a oompACt form, through the use* of 
the ^yocabs-. This compact form can be compared rapidly iagainst all sUcceed* 
ing -concept- commands. Similarly, the first -store- or -ansv- or -vnrongv- 
causes TUTOR to "compile" the' student's expression into a fprm^which can be 
evaluated extremely rapidly when euiother of these coiqpiands is encountered. 
It is during the compilation process that "opcnt" is set. Just as the 
'-vocabs- list tells T^JTOR .hpw to interpret the student's words, so the 
"define student" set' of nomes tdlls TUTOR jhow to treat nemiSs encountered 
in the compilation of 3t student * s ^Igebraid response • So ^ there are many 
parallels between -ansv- '^and "define ' student" on the one hand and -concept- 
and -vocabs- on the other . ^ - 

. -* • . , ■ ■ . ' ' 

Let's look at an algebraic example, as opposed to the numerical examples 
we have treated : . ' * . 



define 

unit 
, at 
write 



r^ndu 

calc 

arrow 

ansv 

gotd 

goto 

wrongv 

write 

no 

goto 



student 
x=v1 

simplify ' 

1215 * . ^ ^ 

simplify thd expression ^ 
^^Jiji^l +>2x - 5 ' ; 

'xi.-^^ $$ pick a fraction between ft and 1 

x<J=x+1 $♦ change Jto 1*to«2 range 

1418 \ ' 

5x+2 $$ ja tolerance 

varcnt-1 ,toofew,x^manyvar . $$ how many x's 

opcnt-2,toofew,x,manyop $$ how many operations 

5x+i:S ' ' ' _ 

You should subtract 5*, not add it. 



f ormok , X , tellerr 



unil: 
write , 
judge 

unit 

write 

judge 



toofew , 

Your expression is not svif f iciently general. 

wrong * ^ 

manyvar o * * 

"x" should appear only once. 

wrong 



- unit 
write 
judge 



A 



manyop 

Not simplest fo3cm. 



\^ wrong 



Unit "tellerr" would cental^ a -writec- involving the system variable 
"formok" to tell the student precisely why his expre^lon could not be 
evaluated. - There^could be several -wrongv- statements in the example to 
cTieck for various specific errors. The system variable "varcnt" during 
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compiXatiori of the student's expression counts the number of refejrences 
to variables. For example^ "x+3x+x+2'** is numerically equivalent to ,(5x+2)\, 
so that this response will matchfthe ^ansv-^ but "varcnt" will be 3/becaus 
"5c'* ,is mentioned three times./ If both x,and y were defined^ the expre^slolr 
"2x+y+4x" would yield a "varcnt" of 3 (two x's and one y) and an. "tppcnt"^ 
6f 4 (two implied mul triplications and two additions^ 

Ih this way "opcnt" and "varcnt"^m)ay be used to distinguish among 
equivalent algebraic responses which^ differ only in form. Roughly speedcing»\ 
what is usually called "simplest algebraic form** ofjben corresponds to the / 
smallest possible Values of "opcnt" and "varcnt". 

e are some minor technical points in t^e eJsove example, ^-randu^ 
wfbh only onie argximent produces a fraction between 0 and ^. If this shpuld \ 
Happen to ^ very close to 0 then "x" would* be unimportant in the expression 
(5x4-2),, so 'ilk seems better to add one to m£U^e ,"x" have a valtie between 1 and 
2, which is ^mpafable to i:^e otherj quantities lit the expression. We 
could have usQ^ hhe two'-argt^ent form (e.g.| "^randu X|8") to pick aix 
integer value "^f^ "x". But^siippos^ TUTOR chooses the integer 2 for V^x": 
then a s1|^dent who happens to give/ "12" as his response will match the -ansv-* 
by acqident since ^5x+2 =*5x2+2 10^-2 12. On. the other hatid^ with TOTfiR 
picking a fraction the student woiild have. to type« something like /< 
'"8*. 93172462173" to accidentally match the -ansy-. This just won't i\iippen. 
Yoii wol^ld have to type different numbers 24 hours a day for hundreds of years 
to matc^' accidentally. -If you want even more security against an accidental 
match >' just change the value of /'x" and check again. Kn skeleton form: 

ansv 5x+2 

' goto varcnt-1 ,toofew,x,manyvar * . 

goto .> opcnt-2| toofeW|Checkup^manyop* 
* Wrongv 5x+12 ' - , . . .V 



.unit checkup. 

randu x ^ $$ -new value t)f x 

calc x<5=xM-1 

judge continue * 

ansv 5x+2 ^ $$ try again 



A further check is that we require exactly one "x" and exactly two operations. 

;There. is a way to give detailed feedback to the student in case his 
expression is not algebraically equivalent t% the desired expression (5:^+2) . 



/ 



o 

ERIC 
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^Suppose his 'incorrect I expression is "6x+2", and thajt you have done a 
-s^toJfea- to save t-he response and a -store- to evaluate it for some integer 
v^lue of X. Then askf the student this question; - i 

/ ■ ■ ■ . 



/ - \ write Wha| is the miner icai value of 
/; . 3(ks,xJ>')+7+2( <(s,x)> )-5? 

If X is/4,' this, will appear on the screen as: 
" ' I 

Whatttis the^umerical value- of 
3 (|) +74-2 (4)^5? 

Many ^tu^entS can handld\a numerical example even if an algebraic example 
give^them trouble, so^ fuhis student is likely to reply ^correctly , either 
with oit without some help, that this expression gives 22*. You can then 
ripply to him with this Jtatement (assuming his alphanumeric response is in 
"string" and its value i|i "result") : 



write 



But yoi 
gives 



If his response was "6x+2' 
the screen as 



expression, <ta,Stringj^cbunt)> , 
Js,result)>, in this case. 

with a value of 26 if x is 4, this appears on 



But your 
gives ^6 



expression , 6x+2 , 
m this caSe< 



'The student now sees that hij 
which it should in the case 
expriession, evaluated for a pG 
conflict. In other words, an^ 
is here ah opportunity for the 



expression "6x+2" does not give the value 22 
lere x is 4. You have fed back to him his ow^f^ 
Articular case where he can see there is a 
(thing he says may b'e usSiig^ against 'him! There • 
student to ^ learn by example a useful technique 
: in simplifying- complicated expAfessiohs: try some numerical cases for wh^ich v 
you know the results and see whether they agree with the sijnpiif ied expreission 



It is possible to judge egiiWtions as well as expressions. Suppose' we 
ask the stutdent to simplify the equation "4x+3=x+ 12^-5". A suitable response 
migh^. be "12y=3x+8" or "x=(12y-8)\/3". Every time the ^tudent enters a 
response,^ let TUTOR pick a random\ value for the independent variable x, 
and calciilate the corresponding value of the* dependent variable y: 



-/ * 
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y <=(3x+8)/12. Thfen any correct equation will be 'true' (with value -1), and , 
an incor?:ect equation will be false (with value jg) . Here is a unit embodying 
these concepts: " ' ' pi 



def irie s tuden t , x=v 1 , y==v2 
unit equate 
at 1215 . , 

write Simplify the equation 
. 4x+3=x+12y^5 ' . . 
1718 ' . 




.\$$ y d^p^nds on 



$$ ran<iom X on each judging 
x<;^+1 \ • 

y<J=(3x+8>/1^ 
judge continue ' - 

.angv -1 , $$ ^og[ical tirije 

goto ideht ^ , ' 

wroiigV ^ $$ logical false 

write That is false. 
. V . * $$ anything ej[ise 

' . write Give me an equation! V * v * ' ^ - y 

, , . ■ at - - ' \ : 

unit ident ^ « . ' ' \ ■ 

■ , eaic y<>=3.72y ' , $$ change y arbitrarily ' ' ' - 

judge continue , ' - 

• wafongv -1 $$ should not now b^ true v 

write That. is an identity! * u • - 

• ok ■ ■ . ■ ] ^ *• ■ '-■r ' " _ * , ■ 

judge varcnt>2,wr6ng;ok ^ . 

writec varcnt>2,NcJt simpiif ied. ,Fine. » ^' ' ' « 

^ If the student writes' /' 3+4" , this expression' has the numerical v^lue''?, 
so the reply is "Give me ^an equation! " , ' ^ 

If the stdident writes - "3=4" , this ejcpr^ssipn has the numerical value 0.^5 
since it is logi^calJUt^^lse, andjihe reply is "That is false." 

' - ' ""^""^ ' ' : > ^ - ' ' ^ . . ■ 

^ - ^ • * j> ' . . i 

If the student writes- "3'^+5a6l 7-3" , which is equivalent to 14=14, TUTOR 
replies "That is an identity!" "^Tl^e student.' s response' is truej 14 does ^ -0 
equal 14, so that this true felationshijv^as the .value -1, which mf^tches^ Sbe 
-ansv- statement. Tlxere ^o^lows ^ •'"goto ident", where the, dependent 
variable y ils changed s(3 that it no longer bears the correct relationship to 
X. If the Student's response had been a porrqct^ simpiif icat^ion of £he' given 
equation, his expression wo^ld no longer be time (-1)\ since y is no longer 
the correct function o£ x. »In the case .of v "3^+5=1 7-3", however,- cha^iging 
y has no effect and €3fie value ±s still ^1, which matches the -wrohgv- -state- 
ment in unit "ident". • 'The student gets the message "That is' an Identity!" 

Only if *the student enters a inon--3,dentical equati^ori will he get an "ok" 
judgment. Note the. check otx "varcnt".^ There/couid also be a check on Vopcnt 



^ To siunmariz'te^ -ansv- and -wrongv- are extremely powerfuL commands for* 
algebraic of h\ini,erip responsesi particularly in assiociation with variables 
.defiAed in the "define * student" set. The. system variables "opcnt", and 
"varcnt" give you ' addit:ional information about 'the form of the response.* 

CAUTION: ' Since. TUTOR performs "'multiplications before divisions (unless 
parentheses intervene) / a student ^ries^onse of "1/2x" is taken f^g, rtiean ' 
"•1/<2x)'^ whereas the student' might have in mind •|<1/2')^"; ^It is imjiortant 
to warn^youi; .students of^ this conventibn at the beginning of a lesson 'jiyhich - 
•uses algebraic judging. Scientific' journals' and most te^jtbooks follow, this 
same convention, but ir^y sij:udqnts^ are unaware of th^s. Usually prin^4d ma- 
terials use the formg -.or -X or ,Thesa forms^ avoid the "ambiguities that 
arise from the slash (/) or quotient sign (v) used bn/"a7single typewjritten 
^line. It ds*. hoped tHat eventually TUTOR will make it easy for Students to 
type fractions with the horizontal bar father than the, slash or quotient sign 
Until then it is important to jDoint out this contention to your students. 

Handlill^ scientific units'; -ansu-, -wrongti-, and -storeu*- - * 



Suppose you want to: 'ask the student for the'dens4.ty of mercury. A^^ 
correct answer would be H 3.6 grams/cm^", but there' are many equivalent ways 
to wrlt^ th4- same .thing. For exaihple^ the student might write 
"13.6xlj0~-^kg/ (.01 meter)^" or-"13.6 gm-cm^^', and both of these responses are 
equivalent to "13.6 grams/cm^, ,|tfUTOR provides a convenient way not only to 
judge such responses appropriately but to -give the /Student specific feedback 
if he ipakes specific . errors' such as omitting the units or giving the i^ight^ 
units but the wrong jiumBer*- - , " i , ' ^ 

^ • The TUTOR scheme is based on't^he judging per foinmed by human instructors 
when grading exam qu^sVions involving numbers and units. The instructor 
makes two separate cdiecks, one for' the numerical value and the other for the 
dimensionality of the units. The dimensionality of density is 

(mass) ^ (length) and it is the powers (1,-3^ that we are^^interested in - 
as well as the number 13.6. All of the equivalent correct responses listed 
abovQ have a numerical value .of 13,6 (in the gram-cm system of units) and a 
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mass-length dimensionality of (1,-3). The -storeu-* command (-store- with 
units) can be used to get the . numerical part and the dimensionality if we 
define the units oappropr lately: , ^ * * 

define Student $$ units will bemused by student 

units, gm>cm $$ can. define up to 1JJ basic units 
^ gram«gm,grams»gm,kg»1JJj3jJgm $$ synonyms'^ 

'^v- mete]c?«1JJjJcm,cc«cm^ 
(Sefine mine,qtudent $$ include student, define set 
\ ^um=^l,dimens(n)«v(1+n) see "Arrays", chapter IX 

unit- dens^ 
'at 1215 1 

write What is the. density of mercury? 

'(Include units 1) 
arrow 1618- 
storeu num,diili|ens (1 ) 
write ' cannot Waluate. 
no 

^ to [ num^ 13'. 6\badnum , x 
goto ' dimens CI )Vl ,badma9S,x * 
goto^ dimens { 2 ) ?\ 3 , badlehg , x 
judge . ok . 
write Goodl 



We will #p to a unit . "badnum" , ^'badmas^", or "badleng" (not shown here) if * 
there is somet^^ing wrong with. number, mass, or length. The* -st:oreu- command 
has two variables in its tag:^ the first will get the numerical part of the 
student's response \ and the second (dimens (l)r in this dase) is the starting 



point for receiving the dimensional information, 
what will et]id up in n]jm, dimens (1), and dimens (2) 
responses: 

" . . . * - ■ 

student response num 

grams/cm^ , 



Here are. some examples of 
for vaLrious s'tudent 



13.6 

13.6 cm-gm^ 
ia^6 kg/ljSfcm 



13.6 
13.6 
13.6 
1'36J3 



dimen$ ( 1 ) dimens (2) 

1 : ^ ^ -3 

^ J3 ' . ^ . • 

2 1 . 

• 1 • ' -1 - 



Note in the third example that a minus sign preceding a unit name is taken 
9is a dash meaning multiplication, not subtraction. Note in' thd last exampl'e 
that "kg"; brings, in a factor of IjBjBlf relative to the basic unit (gm) . • Npte 
also that, 'as usual, TUTOR does multiplications befoi^e doing divisions so 
that the "Ij? cm" is all in the denominator, with the result that we have 
<length)""1. Similarly, 'M/2 kg" will be taken to taean 1/(2 Kg) # hot (t/2)x kg. 
As mentioned earlier, it is best' to point out this matter to the student ajb 
the beginning of th^ lesson. ' , ^ ' 
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Like -store-,' the -storeu- judging conmiand will fl^ip TUTOR to the 
regular state (with a "no" judgment) if it cannot eviAuate the student's 
response. The system variable, "formok"-qan be used in a -writec- tb tell 
toe s^u4erft why his response can't be evaluated. One e'xample peculiar to 
r^srJonses involving units is "5 grams + 3 cm" i which is absurd. * yoii cannot 
add masses and lengths, and -storeu-*^ will give up. On the other hand, the * 
student- can say "65 cm + 2 meter" and ^toreij-^ will set num to 265, dimens(l) 
to jBt (no mass), and dimens(2) to U As anot;hel^ example, "cos (3cm)/" is 
rejected, but "cos(3cm/meter) " is accepted. Th^ argument of most /functions 
must be dimensionXess. (Exceptions are "abs" and "sqrt",) / 

A related difficulty faces students unless you explicitly warn them: 
"3+6 cm" is rejected by -storeu- although it; looks reasonable in context to 
the humgui eye. As far as -istoreu- is concerned, however » the student is 
trying to add 3 "nothings." to 6 cm, and the units do not have the same 
dimensionality.. For —storeu- this is as improper as "3 kg + 6 cm". Unfor- 
tunately, until -storeu- (and TUTOR) get inuch smarter, it will be necessary 
to give explicit instructions to the stxidents that • 

1) Multiplications are done before divisifons (unless parentheses 
intervene), sb that 1/2 kg does not mean (1/2) kg. 

* ■ ■ . ♦ * 

2) -Responses such as "3 + 6cm" must be written rather as 

• "(3+6)cm". / 

^te^. that tjiese rules also apply in scientific journals and almost all text- 
books, but your students may not^ be consciously aware of these standard rules, 
Given only these standarci conventions, -stoteu- will correctly har^le an 
enormous variety of student responses. 

While -storeu- can be used to get the number and dimensionality, usually 
the *^ansu- and -wrongu- commands are. used to check for specific cases. Let 
us modify our sample unit to' use these commands, which are like -ansv-/and* 
-wrongv- except for checking for correct units: 



1^ 



arrow. 1618 
storeu num,dimens(l) 
write ' Cannot evaluate ! ^ 
ansu ' 13.6 gm/cm^,.l 

writer , Good ! • 
wrong\i\^ 1316,11 yf 
write/ Right number, but give the units! 
wrongm (hum) gm/cm^ , . 1 

wtiteL^HEcLght dimensionality, but wrong number! 
wrongv 13.6 , .1 . ' 

write Right number but wrong dimensionality, 
no • 

writec dimens (2)=-3iLength ok. , Length incorrect. 
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The -ansu- will make a match only if the dimensionality is correct and the 
number is 13.6 plus or minus the tolerance (given as .1). The first -wrpngu- 
checks for 13.6 (mass]^^' (length)^? that "is , ^no un^ts given at all. . The second 
-wrongu- looks for a n^riBier^qual to (num>, which it surely finds because 
ffthat is the numbfer th^Qjpudent gave"-(as determined by -storeu-) . Thereforej 
this -wrongu- will match if the number ,is riot 13.6 but the dimensionality is 
correct. The -wrongv,* unl^ike -wrongu-, doesn't care about dimensibnality. but 
only about the numerical, part. It is used here to check for responses such 
as "13.6 cm'\ / . 

The.^-exact- and ^exactc- commands: a language drill ' . -f- 

It is occasionally useful in special dasies to use a^wmmand less 
powerful than r answer- to' judge a response. Suppose^-ymi are teaching the 
precise format required on some business form, and you want the student to 
type "A B C" exactly, with three spaces between the letters. A miatch 
to "answer A B C" would occur no matter how fehe-atudent separates 
the letters . One space , four spaces , a comma or a semicoioR*-an^L^ these 
punctuations are permissible separators as far as -answer- is. conceirned. 
Normally this flexibility is good, for it keeps students from getting hung 
up On petty details. If, however, it is ppecfsely the details that matter 
on a partitular response, use an -exact- commcUit|*^ In the present case, 
the statement "exact A B C" will be matched only if the student types 
exactly that string of charactei^s: A, space, space, space, B, space, spaCe, 
space, C. ' ' 

At the time- of writing the -answer- command doe& not pe^it punctuation 
marks in its- tag, so that a response such as "a:b'' must be judged with an 
-exact- command if the colon is important. While punctuation marks cannot 
appear in the tag of the -answer- command, the student can use them in a 
response. The — answeicr command will treat all piinctuation marks that the 
student uses as being"^ equivalent to spaces. • ' ^ 

~^ ■ I 

It should be emphasized .that it is easy to misuse t)ie -exact- commandV 
The student should normally be given considerable latitude in tl|e *o|^fOf 
his response, . such as is permitted by -^nswer^, -concept-, and -aiisv-^ommands. 
The -exact- command should be used sparingly, and only f or rathqr sjK»fe re-, 
sponsed. ' If it is import^t that Ahe student know the exadt format of »some- 
thing as long as ' ^ * ? ' 

■l\ * 3 No.*^ 6 screws/51 6-21 3-86xq-4': N^w -Orleans . . ' 

it would certainly "be preferable to have him pick this cprrect form oul: of 
a displatyed set of kamples*^an to ask him tq type it exacrtijti Then all ^e 
need say' is that item number 3 is the correct form. 
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There is a conditional -exact- command, -exactc-, which mdy be used to 
crea^te simple vocabulary drills if the poyer of the -answer- command is not^ 
needed: , . ' . * ♦ 

unit e3PP ^ - " 

next espo\ . 1 

at 1812 * * . ^ 

^ write: Give the Esperanto for ' • - 

randu item, 5 

at 2J315 

writec item-2, one, two, three, four, five 

arrow v. 21 1 3 * * 

exactc item-'2,unu,du*tri,kvar ,kvin ^ • 

You might write' yourself a similar unit- to drill yourself on histd):iqal dktes, 
capital^ of nations, etc. This drill has threfe defects — it neveir ends;' you 
may see the same item two or three times in a row? and/iio help i^' Mailable , 
if ypu get stuck. Let's revise it to have tfie foljowftig characteristics: 
It s^hould present the five iteijAs in a random ordeir but without repeating 
any item; any items ijiissed will then be presented again; the student -may 
press HELP^o get the ^rrrf^t answer. 

We will be usi^^g a random seqtience of non-repeating item numbers such 

4.2.1.5.3. / ■ ■ / ^ • / 

This is called a "permutation" of the five integers* Another, different/ 
permutation is the sequence 

^' • 

2.5.3.1.4. * ^ 

. ■ . • _ . ^ 

You can see that there is a large number (12j3) of different permutations of 
five^ integers. CorrespOn(|j.ngly , there is a large number of different per- 
mutation sequences' for presenting our drill to the student. Such sequences 
of non-repeating integeris are quite 4ifferent from the sequences we get from 
repeated execution of our "randu item, 5", which 'jDroduces sequences such as 

^,4, 1,5, 1,2, 4, 3, 5, 5, 2, etc. ^ 

with somt integers repeating and sonie not showing up for a long time. 

We need sOme way of asking TUTOR to produce a permutation for us, rajther • 
than the kifid of sequence procjuced- by -^randu-. This is done by telling 'TUTOR^ 
to set up a permutation of 5 integer^ ("setperm 5") from' which to draw integers 
("randp item") until the sequence is finished (indicated by "item" getting 
a value of zero). The ^-setperm- command actually sets up two copies of the 
permutation, dnd the "r^movei item** statement can be used to remove an integer 
frpm the second copy. {-randp- draws integers from -the first copy.) If we 
-^Bonove- only those integers corresponding to items correctly cinswered on^ the 
first try, the second copy will contain only the difficult it^ms after com- 



plefeing the finest pass ove^ th^ jfi^er items. Then we can use -modper^-* (which 
has nc^ tag) to fttodify the first copy by*shoving the second copy into- the 
first copj¥% Hiiying' replenished the first copy with the difficult it^ms we 
can us6"-*x:ahd|Sii- to choose these ag^in. 



li^re •iS' a iorm of thfe drill incorporating the^e' ideas; 



, '/^ .Vihitr';;' -begin>^ 

>r^setp^inn 5 V.^ 

jump choose 

* ■ . ' 

ui^9,t choose 

cAlc attempt <S=0 

^,^:>randp item 



$§ set up two copies, of a permutation 



jump item>iJ,espo,x 
^modperm 
randp item 
jiunp item>jJ,espo,x 
at * 2115 
write Congratulations! 
* You finished the drill.' 

lesson .$$ end the lesson 



$$ Initialize .n]ciznber of attempts 
$$ pick an integer 
$$ fall tTirough if first copy emp'ty 
$$ use second copy 



r 



$$ ^f all ^through if second copy empty 



end ' 
* 

unit 
next 
help 
at 

' write 
at . 
writec 
arrow 
exactc 
goto 
remove 
no is^ 

• calc 

unit 
^ calc 
-at 

writec 
end 



/ 



espo 
choose" 
esphelp 
1812 ' 
Give the Esperanto for 
2JJ15 ' 
item-2 , one , two , three , four , five 
2113 

. i tem- 2 , unu , du , tr i , kvar , kvin 
attempt>J?,q,x 

item ^ $$ remove item if correct on first attempt 

attempt<J=atteinpt+1 
^phelp^ . 

attempt^cjsattempt'*^^ $$ tjount HELP as an attempt 
1613 

item- 2 , unu , du , tr i , kVar , kvin 




We want to remove an item only if ^e student gets it right on the first 
try, which means "attempt" should be zero, "goto . attCTipt>JJ,q,x'* means 
"goto a fiptitious, empty unit "q" if attempt is greater than 0, else fall 
thtough". If we fall through, we remove the item ("remove /item") . We 
increment "attempt" on §ach try and also wheti help is, requested so that if 
the student has 'to see the answer, the item iis not removed and will be seen 
again.- Note that he^is required to type the correct response and cannot see 
tMs answer while he types, which gives him additional practice on the dif- 
ficult items/. • , 
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. At thi present writing there i§ no c^onditional -answer- command. If 
the spelling power of: the -answ^r^ command is desired in this dri^ll, rejDlace 
the -exaCtc- with a conditional -join- to attach one of f ive -uitits containing 
-answerr commands. You must use -join-, nod -do-, '.since j.t will be used 
in the judging state. ^ * ^. ' 



Stages in processing the -arrow-* command 

Let us summarize the /several stages of ' processing involved when "there 
is an -arrow- .command. 



Stage 1 



"Stage 2 



a. «" 




Stage 3 



\ 



Stage 4 




ERIC 



The -arrow- conunand is exeiquted: the ^rrow is dispXaj?ed**^on 
the screen, and a marker is set to remember the unit and 
location within the unit of this -arrow- command. Regular 
processing continues until a judging ^command is encountered, 
at which point there is a wait ;wj?ile the student types a 
response. 

^Th^ student presses NEXT or otherwise comp^eti^s his response. 
TUT^R uses its, -arrow- marker to start judging at the state- 

. ment* following the ^-arrow^ coiSmand, Only juti^ing commands* 
are executed-rall regular commands are skipped. Execution 
of a -specs^^coirahand sdts a -specs- marker to ^rem^qiber the 
unit and location within the unit of this -^peicsV^ command. / 

Some judging comn\and terminatea judging, afld succ^S^ive 
regular commands: are executed" uhtil a judging command is 
encountered, which ends^this regular processing, even.^if we. 
are several levels deep In -do-s. There is no "^undoing". 
An -arrow- or -endarrow- ^ill also halt this regular process- 
ving without permitting "undoing". (If ^ np judging .command . 
terminates the judging, phase, the end of the- unit, an • 
-endarrow^, or another -arrow* 'will end Stage 3 and make a 
"no" judgment.) \ ' * 

If the -specs- markey has been set, regular processing 
l>egins at the statement tollowirig the last -specs- command 
encountered. . (The -specs- marker is cleared.) This process- 
ing terminates, in the same way as the regular processing of 
Stage 3.1 If the judgment is not "ok", the -arrowr is not 
satisfiec^. The student must erase part or all of the 
response and enter a different r^esponse, which initiates 
Stage * 2 again. - . ' 

The search state is initiated if there. is an "ok" judgment. 
TUTOR again uses the -arrow- marker to start processing at 
the statement following the -arrow- commanfi, this time in ' 
a search for Whether -arijpw-. Only -join-s are executed; 
all other commands, regular or /judging ^ are skipped during 
this search state. If an -arroW- command is* encountered. 
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TUTOR begins Stage 1 for this additional -arr<^w-, / If an 
-endarrow- command is encountered, the searcl^ state ends 
and regular commands are p£T)cessed. If neither Yarrow- 
nor -endarrow- is encountered, 'the student can press NEXT 
to go on to the next main unit, having satisfied all the 
-arrow-s. 



Written out in full >this way, this all soxindsl rather complicated, but in 
most practical cases this structure turns out: tQ be quite natural and 
rQasonable«» It is, neverthelf ss/ useful to lotflc 'aJb-^ome bizarre or pathp- 
logicalvcases to further cla^rify the varioua^rooessing stages. 



Re}J6ated execution c>f ""join- 

Firsts here is ain example of the repeated execution a -join- in 
regular, judging, and search states: 



unit faulty * 
calc , ilS=JZ( ,^ ' ^ 
arrow 1514 < * 
join i<S=i+l^ansdog » ?, 
endai^row. 
at 2514 
* show i • 

unit ansdog 
answer d6g 
write Bowwow! 

Th^ conditional -join- has only one unit listed, so we will always join 
^uni^ "angjtapg'', no matter what value the expression (i<^i+l) has. Upon first 
entering unit "multy", we do the -calc-, the -airrow-, and the -join-, all in 
the -regular state. This terminates at the -answer- cbmmaUd to await a 
student response.^ Note that i is now'l, due to the , assignme'nt (i<r=i+l) ^ 
contained in the conditional -join-1 Suppose the student types "cat" 
and pressels NEXT. TUTOR starts at the statement following the -^row- and 
ejqecutes th$ -join- in the judging state (incrementing 1 to 2 in the process). 
No match is found for "cat", so the student must^ give another response. 
Supposd^he now enters "dog". TUTOR again starts^ judging just after the -arrow- 
and again executes thi -join- (thus incrementing i to 3).' This time'th^re . ^ > 
is •a match to "answer dog'' whicl:^ changes the statp from, judging to regular. 
The "writ0 Bbwwowl "- is executed, *ahd t\ie end of unit "ansdog" cause^/^iElTOR 
to "undo" back into unit "multy", where the -endarrow- signals the end of 
the statements associated with the -arrow-. Since we got an "ok" judgment, 
ye are ready to search for any^ other -arrbw-s that might b^ in unit ,"mutty". We 
return to the rarrow^ one last time, this time in i^e search^ state. The -join- 
is executed to see whether there is an -arrow- command lurkijfig in unit "ansdog", 
with tl\e incidental result that^i gets incremented to 4. '""No -arrow- is fo^ind 
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in unit "aiisdogV and we "undo" into the -endar row- command, which changes 
us from search state to regular state. The. -at- and -show- •^are executed 
and we get/'4" on our screen, - due to the quadruple execution of the -join-. 

Aside from ^lustra ting some consequences of the processing rules, 
this example shouW emphasize that' using the assignment syihl^l (<r) in 
a conditional -^oin\may have unexpected results! Note that -join- is the 
only command with thei^ properties, diie to the fact that it is' the only o 
command executed in regular, judging, and search states. It is important 
that -join- be universalW executed in' this way so that you can join 
judging commands in the judging state and even -arrow- commands in thej 
^ search state, not just regul^9^<:ommands in the regular state. 



Judging commands terminate regular sti 



The rule that a judging command 
commands is an important and general rule 
be true upon' first, encountering an -arrow- 




the processing 



seen that :his mu^t 



the first judging 



of regi:jlar 



the -arrow- makes "^UTOR wait for a student response, since that judging 
command needs a response to work on. Let's see another instancse of the rule 



command after 



arrow 

answer 

write 

wrong 

vyite 

wrong 



1518 
dog 

Bowwow 
cat 
Meow 
horse 



If the student says "dog", he gets a reply "Bowwow" and regular 'processing 
stops at the "wrong cat" because -wrongs, a judging command, terminates 
the regular state. Similarly, if the student response is "cat" , the state- 
ment "wr^te Meow" is the only regular statement which is executed. The 
judging commands delimit those regular citounands associated with a match of 
a particular judging command. This delimiting effect is achieve^ because 

, 1) regular commands , are skipped in the judging state; and 
♦ 2) the processing of regular commands ends whenever a judging 

command is encountered. 
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w let's consider a slightly modified sequence: 



arrow 



write 
wrong 



1518 
dogcatr 
Meow 
horse 




unit dogcat 
answer dog 



write 
wrong 



Bowwow 
cat 



supposedly the ";join dogcat** will act as though the statements -of unit 
"dogcat" Were inserted where the -join- is. Which should make thi3 modified 
version equivalent to the earlier version, Indefed, the rule that a judging 
command terminates the processing of regular commands does make "^he twb\ 
versions equivalent, as we will show>( Remember in this discussion that 
-join- is the saiTi\e as *-do-\ except for the universal nature, ^ofi-^ join-* 



Suppose, the student types *'dog". We start just after the -arrow^^in 
the judging state. The -jo:y;i- is executed and we find a matching / 

^erj^g" which end^rjudging* Snd puts us in the regular state. Aphe 
."writ^"'*'^ Bowwow*^ is executed. 'Then we come to a -wrong- judging expand- 
which stops the regular processing and prevents "undoing" I Even though 
we 'ar^ on^ L^vel deep in -d©-s,' TUTOR will not "undo"; the "write/ JMfeow" 
which follows the "join dogcat'^ will not bfe executed. What viAl ftappen 
is just what happens in the earlier version-: we have an "ok" judgm^t, 
wh^ch causes the search state to be initiated at the -arrow- t there/ was no 
^specs-) . Thus the two versions operate in identical manners because' the 
-join-, acts like a text- insertion. Note that a response of "cat" will 
get a reply '^Meow" because^ there i^ no judging command following the 
"wrong cat"; a normal "vindo" is jierf ormed at the end of unit "dogcat". 

This l^st example illustrates the importance of the rule "adjudging 
command terminates the regular state". It is this rule which insures that 
-join--, (or -do-) will act'dike a text insertion. ^ ^ . 

* We saw in the discussion of the -goto- command in Chapter Vl that a 
-goto- in a done ui\it 'destroys the strict text- insertion character of the 
-do-. That is •true in the present context as well. Suppose we^ insert a. 
-goto- In unit "dogcat" (any -goto- will* do; we'll use a "goto* q*) : 

unit \ dogcat 
answer .dog 
wrxte Bowwow 
-V \^^goto . q 



wrong cat 
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The student enteris "dog" and we do unit "dogcat"/ where the match to 
"answer dog" flips us from the judging to the regular state. The regul^ar 
commands^ -write- and -goto- are'' executed. (Note that -goto-, like -do-t! 
is oVily iregular, whereas -join- is universal^ being executed not only in 
regular but in judging and search states.) The execution of the -goto- ^Dre 
vents TUTOR from encountering the "wrong cat". which previously terminated 
the regular state. We have run out of things to do in unit "dogcat" and' 
are one level deep in -do-s.' TUTpR, therefore, "undoes" and 'executes the 
"write.. Meow"^ which follows the "join dogcat"! The student will see 
"BowwowMepw" on his screen. If, on the dther hand, we replace the 
"join dogcat" with the statements Contained in unit "dogcat" we would 
have " 



arrow 


1518 


'answer 


dog 


writ:e ' 


Bowwow 


^^yoto 


q 


wrong 


cat 


write 


Mjfeow 


, wrong 


norse 



and 'a response 
hot "BowwowMeow/J 



^•dog" would merely cause "Bowwow" to 



kppear on the scree 



We have atfain seen tKat a -goto- in a* done, unit c4n cause the -join^ 
operation to hfehave differently frc^ a text-insertion.' get different 
effects depending on ^herther we -j din- such a unit or put that unit's / 
statements in/ place of the -join- statement. » 

This property of the -gotd- can' sometimes be used with good effect. 
Occasionally you may w^t tc "un4o" despite the presence of a following 
judging command, in which case you can use a -goto- /to prevent TUTOR from 
seeing ^hat judging command. Conversely, you can place a judging command 
at the end of some^regular commands for the express purpose of preventing 
the **undo". ' ' 
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-goto-^ IS a rg^ular command 



SinceS^the -goto- command is a regular command, it is skipped in the 
judging and search states. Here is an eirroneous sequence ^of commands which^ 
illustrates the fact that the -goto- is skipped in the judging state: ^ 



arrow 


1612 


goto 
-* 


dogcat 


unit 


docfcat 


answer 


dog 


write. 


Bowwow 


wrong 


cat 



When the -arrow^ is first encountered, an arrow ^4s displayed on the screen at 
1612. TUTOR continues in the regular state and executes the -goto-. The 
-ansvj^r- in unit "dogcat" ends this regular processing to await the. student Vs 
response. Suppose the stu'dept types"liog""an<3 presses NEXT, TUTOR. , starts, ' 
judging just after the -arr^w-, skips the regular -gotor confmahd|; ai^^^^^^ 
no judging commands at all!^ The student Is response' gets a 
judgment. The -goto- should'^be replaced' J^y a -join-- sO thap unit 
willy i>e attached ip- the judging state. ' 

Similarly, here is an erroneo;us sec^uence to illustrat 
the -goto- command is skipped in the search statje: 



7 

- / si 

:/ 





th^ fadt that 



arrow 1612 > 

specs bumpshif t 

answer dog 

goto another 

wriong cat ^ 

unit another 

arrow 2514 

answer wolf 



The student 'responds to the first -narrow- with "dog" and matches the 
"answer ^ dog", which switches the processing from the judging state to the 
regular state. The -goto- is executed, and in unit "another" we encounter 
an -arrow- command. This -arrow- command terminates the regulir processii>j^ 
jiist as a judging comniajid would. The. -specs- marker/was set, so we will now 
execute any regular commands following the -spe^^s- cqranand (there are none 
in this example). Since the s tv^de ^t ' s response/>ag-^'ok'^ , the search state 



is now initiated. TUTOli starts at the "arrow 1612" looking for another 
-arrow* command. The -specs-, -answer-, -goto-, aixd -i\(m»g- sCre skipped in 
the search state, and we come to the end of the unit yfthout finding an, , 
-arrow* Thus the -goto- did not succeed in attach'ifi^ a second *-arrow-. 
If th6 -goto- is replaced by ,a -joih^, the "wrong cat" will Ipe associate4 
with the second -arrow- (2514)! Thia^is due to the tdxt-insertion nature of 
the -joinr, which interposes the statements of unit "another" between the . 
"answer dog" and the "wrong cat"; One correct way to' witire this sequence 
is like this: - • r . ^ ~ , 







arrow 


1612 


specs ' 


bumpshift 


* answer 


dog 


wrpng 


^at ' ^ 


\ endarrow 


\ goto 
\ * 


another " 


Wit 


- another 


arrow 


2514 


answer 


wolf 



?$ or "do 



another" 



The -goto- or -do- placed after the -^ndariow- wilJL nSt cau^e any mi 
because the search state has been completed: the -endarrow- f\ips us f rotoi 
search state to regular state. 



hiel 



Considerations of this kind mean that some care must be exercp.sed wheii 
using /-join- or -:do- to attach units containing* -arrovf- . copnands To avp|d 
unpre^idtabie Results follow these two rules :^ 0 ^ 



A) A unit attached by -join- or -do- which contains one ^ more 
Harrow- dommemdsw must end With an -endarrow- Command. \This 
Insures that the unit will en<rand "W^^o" in, the regular stat^J. 
(It is perttii/ssibj^ to have regular commands .following ^e | 
^endarrow- .•^) r • , ' !/ 



2) The attached unit containing , one or more -arrow- coimttands ^ ' 
mjgt .not contain any -*gotp- commands. (A -^goto^* can make 
HjTOR fail to see the -endarrow- or a judging command so. that 
a^premature "undo" occurs. ) -Tl ■ 



If these t^^o^les are^ followed, the -j 
as;jthoti§h^ you .had inserted the statemer 
iain- or >-do- was. - 



por -do-^ will act precisely 



r 



:sjrof the attached unit wher4 th(p 
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Interactioris of -arrdw^-^itht-size-'i -rotate- j "-long-i' "^ jkey-i and ^copy - 

When an -ar^^- coiraaand is performed, several things happdn^ An 
alrrow character is displayed on the^ fecreen, cujLrig the student tp enter a 
response./ A note is^ma'de of the unit^and location within that, unit of, 
the rarrbv^- conanand so that TUTOR can returnflfo thisNtriarked spot, when 
necessary. Even the'tr^ai'l of -do-s' (and/or -join's) which brought TUTOR 
1:0 this -arrov- command is saved> so that .each res tartj, at the -arrow- will ' 
be at the appropriate level of -do-r relative to ±he main unit. The current 
settings of -size- aod\-rotate- are saved to be rfeS^^ored each time, so that 
yqu can write a siae-3 reply to a student's incorrectxesponse without 
affecting the size of his corrected typing. In other words, iresponse-cpnting^nt 
settings o£ -size- and -rotate- are temporary, whereas in other circum*- 
stances they are permMent until explicitly changed: 







• • •■ * 


'fit. 

t ; / 


• 






size 










^ rotate 
_ , arrow 


1718 ^" : • 








* , answer 


dog 


'■ - ■ ■ % 






r size 










rotate 


Wobf! 








. write 








. answbr 


* wolf ^ \ 'i 








endarrbw . / [ / 








' "^'at > 


2218 ' . / ^ 




i. '- 




write 


This- is in size 2, rotat^ jj. . 















r 



I 
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The last writing appears in size 2, Rotate J^, despite the size 4, rotate -3;?, that 
were contingent on the student "^s response, "dog" . When the search state is 
initiated, the,;,original size and rotate settings are restored. Similarly, if. 
"dog H had been judged wrong', the s"^dent's revised typLnq ^o^ld have been in 
size 2, not 4, because the original size ajid rotate are restored before waiting , 
for the student's revised input., ; ♦ .~ > 

pxecutiri^ an -arrow- command has other impor^nt initialization* effects: 

. • ■ ^ - ' , . w ■ • ' 

1) A default resporiseV-limit of TSjlJ chai;acters is set. The student . 
: • canrtot enter a response longer than 15/3 characters (including 

"hidden" characters such as shift-codes , and superscript's). 
^ This can Jbe altered **by following the narrow- command wi€h a 
* -long- command to change this to as mucli as' 3)3/3-* If this is . 
^. a "long 1", judging will commence as soon 4s. the sttident 

j!^" types one character. If mor<^ than 1 is specified the student 

is prevented frora\eAtering more ^characters ljut must press 
NEXT to initiate^udging* unless a ''fbrce loiig" statement 
has appeared in the unit. • 

, . - K ( - ' ■ , ■-.^ 

^<-.,.; . ■ ■ ■ - • ■ ,121 \ ' ■■ ■ • ■ 
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2) A d^faultispecificatiori of '•jjtidging^ kfey^^^^^^ Only the 
^NEXT. key ci^tjsfe judging to ' stair^^ (pr^^^^ 

is a'nong. 1", or hitting the ''f oyce Ibn f w 
^ ThiSi^ can be altered bjr followiosh-^^^ 

-jkey- command to apecigs^T atdditional ii^dgfinq Koys (JilEXT is ( " 
^ always a judging key) . An example is '^^key^^ data,help - which 
f would make the DATA, and HELP >keys 'equivalent- to the 

H^i-s arrow. ' - ' v-'.-'j!"'^^ 

, . f ^ _ . ■ _ . ^ • _ , ■ ,, • ■ ■ ^ , 

3) A default specification is set to disable the COPY key'^^ T^ 
-arrow^' command can b6 followed with a -copy- conanahd to 



* — . specif y a pr^yibu^ly-stored character slyring to ^e referenced 

. with the COPY key. An e»am^^^ "copy: " ' V51 ,73*"/ ;^here v51 is 
the start qf the character string and ^^v3 is the number of cljarac^ - ^ 
ters. This way- of' ^ecifying a string" of characters is the S|.aine Z 
as the scheme used with -storea-- and -shpwa-, - ' j. 

^ Some explanation* of the COPY and e6iT keys is required. • The EDIT key 
is alway^ avallcd^le for thfe student to use in correcting his typing • Pressing : 
the EX>TS! key the first tiime ^rai^es all typing/ after which eacjh press of . the' 
^ EDIT key l3|i5|yags back tl^lf typing one vrord a^ 
make cprreotions and insertions withDut a iot of v^etypiiig.^ ' of th6 

COPY k6y, on the o^ther hand/ brings in a word from the character string ' 
specified by the -copy- ConraiandV as Oj^ppsed to bringing in the student *S 
own typed words with the EDIT k§y. One examjale^df-^the u$e of the c6pY; key 
is seen in the PLATO iessoh editor, where yt>u W^an author can use- ^ ^ > ^ 

key in iinisert or repiace iftode to bring •in po^rt^x^is of a. precedihg line with-, 
out' having to retype. The COPY key m\ist be specif ically enabled by a -c?opy- 
command, but the EDIT key ;; is afcways uj^able^ .unl^ kpecify a -long- 

grea]te^ than the normal limit, of 150* (To use the EDIT key on resjionses longer 
than 15^f characteirs requires you to furnish an edit buffer through- an -edit- 
command. ) v ^ ^ » v*" ^ " ^ ' 

The -loBg-, -jkey-,.:arn(i^^cbpy- commands all overiride default specif ications 
Si^et by the -arrow- command. They cain:,^^^ thought, of as' modifiers of the -arirbw^ 
command. \ If they are to have an effi^ct on the student's first, response they 
not only must' f olloy? the^-arrow- command' but muB^t j^recede any judging Commands; 



arrow - 1518 / ^ ' 

("jkey help ' , . ' " \ 

< copy ' cstring,ccount - ' ' 

(^long 15 ^ ^ ' • • 

. rspecis- or -answer-, or -store- or any other judging command 



If -j key-, -copy^, or- -long- came after the first judging, command, the.-arrow- 
d^f auJl4:s .wouldf hold for ^ the first ^.re3ponse because' the modifying command 
Would' not have) been executed ^et. , ; ' ^ 
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Applications oi ^ jkey"* and ^ansr- / / ^ # 

Use of the - jkey*- command is well illustrated jLn .the case of providing 
help to the student through ^ the HELP key butc; without leaving the puige. It 
giving help requires an entire screen display, or a whole sacpaence of H^lp * 
uiiits, it is best: to use ,a -help-* ccxnmand to specify where to junqd if ihe 
student presses HELP/ The screen is then erased automatically to make room 
for the help page (imless the original base unit had an -'inhibit erate^ in 
it):^. On the ot;her hand, the appropriate help might consist cl^rdly of a brief 
<:onmient or some' additional line-drawings on the present page. A convenient 
way to provide such help withoVit leaving the page"* is IsHia^* 



arrow 18'15 

jkey help * - " - 

cinswer cat 

no , • 

write Hint: it miaows. 



The statement "jkey help" . maJces the HELP key completely equivalent: to 
the NEXT key. If the student presses HELP, judging is ^initiated, his (blank) 
response does ^^ot match "cat", arid he gets "Hintt it meows. •••" Without the 
^fkhy command, the HELP, key would be ignored vi|^ich would be bad. It^is a 
very good idea to have the HELP key do something at all times so that the 
student can_ come to expect help to be available. 



In this^ example the student will get th^ same assistance whether he 
presses HEL^or whether he types "dog" followed by pressing NEXT. We could 
^ive* different kinds of assistance in these /two cases by changing the -write- 
statement to, a -writec-: s 



arrow 1815 

jkey help . 

answer cat " ' , 

writec key=help, Meow?, The answer isicat. ' ' 

The system variable "key" always contains a rjiunber correspondiijg to the last 
key pressed by the student. In this case th^ last^ey will either be HELP * 
or NEXT. ^If the student presses HELP, the logical expression "key«help" will 
be true*(-i) and the student^ gets the reply ''Meow?" But if"he' pressea NEXT, 
then the logical expression "kQy=helip" is false (J8) and 1:he student gets "The 
answer is cat." The lower-case word "help" i^s defined by TUTOR to mean in a 
calculational expression " the number corresponding to the HELP key" Other 
such defined names include next back, he^pt (for shif t-HELP) i etV*^. - 

■.■ ' ' . - - •/ ^ ■ • ^ , \ ' ^ ■ ^ 

\ s ' ■ 

* There is now a -helpop"^ command, similar to -help-, fox providing help on 
the page (op> without erasing the screen.' 
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An alternative way of writing the same sequence is thisi 



arrow 1815 

ikey help 

$$ terminate judging , 

. ^ dudge key-help, X, continue * 

write Meow? - ^ 

answer cat • , 

no K \- 

write The answer is cat. 

If key-help, we "fall through"' the -judge- command and write "Medw?" If 
the key i^not equal to help (that is, the student pressed NEXT), a 
••judge cont:inue^' is performed to return to the judging state. The 
"write Meow?^: Is skipped since -vnrite- is a regular command. If the 
response does not match ••cat", the student will get the message ••gJhe answer 
is caV\ As usual, there are many equivalent ways in TUTOR to do the same 
thing 1 In a particular siti^iatioh one scheme may be more- appropriate than 
^another. \ 



There is an ANS key on the keyset which is often used to let students 
skip through material by just pressing ANS: 



arrow 1817 
jkey cins 
ok 

j udge * key=ans , x , continue 
write The answer is cat 
answer cat 



Since the ANS key generates an ok Judgment here, the student will move on 
immediately to ^he next arrow or unit without having to type the correct 
answer. This could be made conditional on the student being in a review 
mode. That is^j/ou might define "reviewavl", zero it initially, anii s^ it 
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to -1 only after the student has gone through' the material once undier his 
own power. With the following structure 



arrow 1817 

do review, jams, X " • / 

Ok • • ' • 

judge key=afts I X ^continue ^ ^ • 



unit jans . . 

jk^^^*' ans' , ^ 

he will be able to use the ANS key only whe^ reviewing the material. 

^ There is an -ans- command (blank tag) which is equivalent ^to 

jkey ans • . ' 

ok 

judge key-ans $ x i continue 



In other words, you just writ^ 



arrow 2123 
ans 

write The answer is cat. 



The -ankr command is a judging command and must be the first judging command 
after th^ -arrov^. When it is first encountered, it ^ets up ANS to be a * 
judging key, and it is matched only if the ANS key is pressed. If the -ans-, 
coitpiand is used only to provide a kind of help, but not to let the student 
pass on to the next thing, put a judge/ wrong" after the -ans- command. 

X I / ' , . 

In many places you may do specific things in response to the ANS aAd 
HELP keys. Elsewherjfe/ in the lesson, it is appropriate merely to enable them 
so that something wJLll happen wh6n these keys are pressed. Just put 
"jkey help^ansjVafter each such -arrow-. The student will then 9©^ .at 
least whatever r^ly you give him after the universal -no- that catchel all 
unrecognized responses. ^ certainly every -arrow- should provide some kind of 
feedback to unrecognized responses or the student will get hung uj). The 
"jkey help, ans" will further insur^^that a reasonable response to his input 
is always forthcoming. Without this -jkey- statement, nqrthing^ would happen 
when the student pVesses ANS or HELP. \ ^ ^ 
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hn additional refinement is adviseUDle. Often a student will 'press 
an extra timoi pisrhaps because he hadn.H: noticed that he was to type a response « 
This blat|k response^ consisting of J^st^ a NEXT key« will probably get judged 
**no*? at most arrows^ which required an additional NBXT (or ERASE) to clear 
the\"no" judgment before typing a response. This can get confusing. In most ' 
cases is- best siiq^ly to ignore bl2mk responses^ 



• \ 

, arrow 1914 ^ ^ 

{exact ^ $$ check for blemk response 

judge ' ignore \^ . * 

' answet . cat \ 

• ■ ■ • . N ■ \ 

This has .the effect of throwing away superfluous NEXT keys.* 

On the otheg: hand, yoti should accept blank respoilses involving ANS or * . 
HELP. It is useful to write ' . 



arrow 
join 



1917 
anshelp 



answer cat 




unit 
jkey 
exact 
judge 



anshelp 
ans^help 

key»next » ignore , continue 



Placing "join anshelp" after each -arrow- will insure that extra N^T keys 
are thrown out but that responses involving ANS or HELP keys will fall tl}rough 
to whatever reply you give to unrecognized Responses. Note that you must^ 
use -join"-! not -dori to attach unit "euishelp"i since you want not^ only to do 
unit ^shelp in the regular state to specify -jkey*- 1 before the student responds. 
When the student respocvdSi you also want to do unit anshelp in the judging 
state in order to reach the ^^exact- judging commani. 



Modifying the response: -bump*" and -put- 



' \ 



It is possible to delete characters from the jjudging copy ofN^he student's 
response by using the -*bump-^ command: 



arrow 1812 
bump as3 * f 
answer rdvrk 



$$ delete all a^Sis'^Si and 3*s 
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* The statement "inhibit blanks" can now be used to ignore superfluous NEXT 
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This -answer- will be matched if the student types "33 aardvarks" because , 
the -bump- command reduces the judging copy of response to " rdvrk", The'n ^ 
original response Is not altered and can be recovered with a "judge jfe judge". 
Also, the screen display is unaffected: the student still sees on his screen 
"^"33 aardvarks", just as he typed it. On the other h«und, all judging commandif 
following the -bungj- are affected since they all operate on the judging copy i 
not on the original response. For example, a -storea- following the -bump- 
would give you "rdyrk". Here la another silly example: 

define cfirst^vl ,csecond">v2 
first««v1 1 ,second«v21 
^ . unit conson 

at ,913 

write Type anything, and I'll * 

remove the vowels: . 
arrow 1309 ' ' 

: " long l/JjJ $$ from v11 tb v21 is IjJ/J characters 



storea first , cf irst ^j Count 
bump aeiou 

storea second, csecond^jcount - ' ^ 

write You typed <a, first, cfirstj> 

Remove vowels: <aj second, csecond^ • 
You used <s,cf irst-csecondp^ vowels. 

Note that "cfiifst" is the number of characters (inqludirig Jiidden characters 
such* as shift characters) in the original response, whereas "csecond" is the 
number of characters, -after the -bximp- has removed the vowels. This is tme 
because "j count" always has an up-to-date character count of the judging 
copy, as influenced by -bump- and related operations. (You may recall that 
-"specs buftipshift" also affects "jcount" by removing shift characters.) 
Suppose the student types ^Apples taste funnier" «^ Then he will get this 
reply: • , 



^ / You typed Apples taste funnier. 

./ 



/ / xou Tiypea adj: 

/ * Remove vpwels: Ppls^'.tst fnnr. 



I' You tased 7 vowels. 

^..--The reason that /the word "Apples" turns into "Ppls" with a capita^l "P*' is 

that a capital "A" is really a shift character followed by a lower-case "a". ^ 
With the "a" bumped out, the- shift character stands next to the "p", making 
a capital VP". ^ 
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While "the -bump- cbinmand wiJ^lSielete characters i the -put- ccimmand - 
will change pafticular strings ©f chara^?t»f rs : • • 



arrow 

put 

storea 

Ok 

showa 



1218 
cat»dog 
rat»inouse ' 

first I cfirst <^ jcount ^ 
£irst|C£irst 



All occurrences of "cat" change into "dog", ^nd all occurrences of "rat" 
change into "mouse". Suppose the student types "Scattered, cats scratch r^ts". 
The reply will be "Sdogtered dogs scmousech mouse^'l 

Both -bump- and -put- are iudging commands: theK operate on the student's 
response. Like all judging command^!, they stop processing when encountered 
during the processing of regular commands. ^The -put- 'coimnand has a property 



similar to -store- in that^it can t^i^irfminate judging with a 
it cannot handle the student's response: ' - 



lo" judgment if 



\ 



arrow 
put 
write 
ok 



1218 

cat-enormous 
Too many cats! 




\ 
> \ 

If the student> has irtan^-iicats" in his response, the *-put- may cause "jcount" 
to exceed the 3i2fjZI-character response limit: In. this case, it changes to the 
regular state, and the student gets the message "Too many cats!" This 
'regular -write- command normally is skipped, since we're in>^he judging state. 

There is an equivalent form of -put- which is often easier to read: 

put cat=dog 
putd /cat/dog/ 

putd , cat, -dog, . 

All t&ir ee of these statements are equivalent. The -put4t (d for delimiter) 
takes the first character as the delimiter between thi^^ two chciracter strings. 
Other examples of its use are these: 



putd 
^utd 



/^/equals/ 
/ // 



$$ convert = sign 
$$ remove all spaces 



/ 
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It is also pqssibjie to change variable' character strings by using -putv- 
(v for variable): • ^ 

putv fir^ticfi^st I secon d^! csecond ^ . 

- string ai)^ count ^ string and count 

In using these -put- and -bump- coinmands in combination, care must be 
taken in their order. For example, the following sequence is nonsense: 

bump a ' 
put cat=dog 

With all. a's bumped the -put-^!j/ill not find any cat's. Similar remarlTs 
apply to sequences of -put- coramfidfids. 

The -biunp- command looks for single characters, so "bump B" will 
n6t merely bump capital B's. ' All shift characters will be bumped as well as 
lower-case b's. In ot^er words, "bump" B" is really "bump shift-b". 
If you want. to eliminate only capital B's, use "putd /B//"\ This will 
find occurrences of the string of characters ^'shift-b" and replace this 
string with a zero-length string, thus deleting the B. 

The main purpose of -bump- and -put- is to m^e minor modifications to 
the student's reponse to convert it into a form which can be handled by 
standard judging commands, • For example, the word-oriented judging commands 
(-answer-, -match-, -concept-, etc.) ceinnot find ipieces of words. Suppose 
that for some reason you need to look for the fragment "elect"; you don't 
care whether this appears in the word "selection" or "electronics" or 
"electoral". Do this: 



arrow 1723 

specs okextra 

piltd /elect/ el^ct / 

answer elect 



The -putd- i^^^iised h^e to put spaces before and after the string "elect" so 
tfhat it stands oirt»..^s a separate word. ^You could also use thq values of 
"^count" before and after executing the -putd- to determine whether, "elect'* 

present. How many times it appeared could also be determined from these 
values><i^The value of "j count" will increase by two for each insertion of 
two extra^ sj:>aces. , ■ 
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JManlpulatjnj character strings 

— ^ ;~ ^ /, 

* • , • ■ , • 

The judging commands -bump- and -put- operate on the judging copy ^of 
the student's response. It is sometimes u^ful to memipulate other strings < 
'of chfiuract.e?r*&. with -pack-, -move*-, and -se^ch-i These commands are* regular 
commands, r\ot judging commands; like -showa-> j:hey operate] on stored cheuracter 
strings, not the judging copy of ihe student's response. Tiiese command^ are 
mentioned here becaudis they are often used in association with . emalyzing 
student responses. in« particular , the judging command -storea^ can be used 
to get the response character string. Thenyit can be operated on with 
-move- and -search-. Finally the altered chsbr^ter string can be loaded 
back into the judging copy witly the Judging conmtBhd -loada- 
(load alphanumeric; the -loada- gommand is precisely the opposite of . ^ 
-storea-). Since thisi^ sec ti6n deals with a rather esoteric topic, you anight 
just skim through it now to get a vague idea of what chair^acter string manipu- 
lations look like. If later you find a ixeed for such operations, you shoul<l 
return ty^ktudy this section with some care. " ^ 

Here is an example of a -move- statement: • ' 

move v3,5,v52,21 ,8' ' 

This means "move 8 characters from the 5th character of the string that 
starts in v3 to the 21st character of the string that starts in v52*'. The 
21st through 28th characters of the v52 character string are replaced by- 
the"^h through the Y2th characters o^ the v3 character string;. The v3 • 
character string is unaffected. In other words, -move- has the form 



move stringi ,start1 ,string2,3tart2,#characters moved ' 

If the number of characters to move 'is not specified, one character will be 
moved. ^ • , * ^ 

^ ■ • . \ . 

Here* is an exa^r^le of the use of -^ove-. Suppose the student types 
••x+4y = y-3" and we want to convert. this into the form "x+4y-(y-3)T before 
using -store- on it. Assiime "str" has been defined: 




1812 
.=.-(. 
str> j.count 

•) • ,1 ,str, jcount+1 
continue 
str, jcount+1^ 
result 



%% x+4y«y-3 
S$ x+4y-(y-3 

$$ to do regular -move- 

SS x+4y-(y-3) 

SS to do judging -loada- 



Subtracting the right side of 

your equation from the 

left side gives <ts,result> . 
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In the -'^move- comznand the parai\lJiesi*s within single quote marks » *)S means 
a character string one charactezr long consisting o"£ a right parenthesis. 
Similarly^ ''dog* would denote a. character string consisting of djO» and g. 
Qhsgracter strings up to ten characters in length may be describ^a^^^this way, 
using single quote marks. The -move- condnand shown albqve moves the 
* character of *)*, which is; just 3^ right parenthesis, tq the (jcountHhl)th 

character positioi> in "str".' This effectively appends a right parenthesis ^ 
to the student Vs character string (as modified by the -putd-) . The -loada- , 
cbmmamd moves xhe final character string into the judging copy so that -store- 
can operate 04 it* Note carefully the switches from judging state to* regular 
state and back again/ 1 . 

1 The -search- commgtnd is used to look for occurrences of sf 

1 ^ chiaracter stagings* It iias the form^ 

\ • ' ' 

i ^ search striijig^,^eftgthj iL ^tring2 j» £engt h2 , start2 /return 

\ string sought string to | return location 

\ ' . / look through * v ; ~ 

V ' ^ where to' , 

; , ' start 

', - ' ■ " • • 

Suppose we use -storea-^to place the unait^ed student response "x+4y=y-3" 
in "str, jco^t". Then use 

■ $earch ,1 *str, jcount,! ,charniuir ^ > 

\ ^ Vpi^ v.- j-— — ^ % ' / 

look £or . .jr v^^, ^ . . J 

I. . . " . string return location * *^ 

■ f^?" , to look 

long) start at ' 

^ * beginning 

tt. ' * of string \ 

. ' • . ' 

This -search-^ command will set the variable 'Jcharnum"" to 5, sine e^ the equal 
sign i^ the 5th character in '*x+4y=y-3". If the ^search is unsuccessful, 
^ "charnum" is set to -1, As further illustration of -move- and ^search-, let's 
rewrite our earlier sequence' without thfe -putd-: 

*» 4 ' ■ ■ ■ ■ ' " ■ »* - 

arrow 1812 • \ 

storea str,jcount % 

search '=»' ,1 ,str,^count,l,charnum 

* Now tnake room for the -( : > ■ . 
move str,cha?num-i-l ,str,charnum-i-2, jcbiiht-charnum 

. *Next insert the - ( : ^ ^ 

move •-{• ,l^,str;Chamum,2 $$ move 2 characters * 

* Append the ) : ' 
\ move • ) • ,1 *st:c, jcount+2 

judge continue 

loada str,jcount+2 ^ , 

store result , . ^ 

' . ok 
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characte^^^Bta^iritas up to 
be placed in vaflabl%s 



moves the lattea^part 
, The second/ -move- 
(=y) which were there 
Lily the -search- would *" 
ire of the case where the 
case ^harnum" would be 



The -search-, finds the equal sign.. The first -move 
Of the string to make room for the insertion of 
makes, the insertion which overwrites the ; character; 
originally. *The third' -move- ajppends the ' ) ' • No: 
be followed by a "gdto charnum^noeq^x" to take 
student did hot in fact use an equal sign> in whic 
-1. . ' ■ . , 

The single quote marks can be used to specify 
ten characters long. Longer character strings can 
with a -pack- command; 

* •. ' • 

pack v11 ,abcde^ghijklmn6pqrstuvwxyz 

This V%^Hs a character strii\^ 26 characters long ixito v11 and follclwing 
variable's. Since each variable holds' ten charactezlsV VH and y12 wtill! be 
full, while v13 will have the la^t jsix charac ters ■ 

might be considered analogous to -storeps^gi^^since both place <?haract3r 
sti'ings in variables^ In the case of -storect'^i the total character count . 
can be gotten from the system-defined vaK^le ^*^(Mnt". ' The character, 
couht involved in a -pack- statement can Be obtaineo^^^th an optional fom: 




/ 



pack 



character count 



Y3,v1 1 ,abp<i^fghi^lmnopqrStuvwxyz 




string location 



\ 



In this case, the -pack- command will set v3 to 26, the total character 
count. , This form of the -pack- statqjment is the only exception to tKe 
general; TUTOR rule that optional parts of a statement go at the end of 
stateioeut^ ^Th^s exception is due to the unique string syntax of the . 
-pack- command. * It does have the effect of turning some, thinga-around: 



v1,v2,H2SO^ 
v2,v1 



pack 
show^ 

^ ■ • ■ , ■ . . • \^ 

This will display "H2SO4" on the screen. Not^ the inversion of order of . 
v1 ^d v2 in the^two commands. Incideiitally, the cli|^tx:^ter. count in v1^ 
wiliv be ten, including tlyree shift codes and two subscribts. The character 
string H2S0^ is actually composed of shift, h, subscript, 2Vsshift, s, shift, 
o, subscript, 4. 
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There are a few other 
: time ^ -clat.e'^^ get s today * s dai) 
atudetht is regfistered iunder / 
in* For ex;aiaple; *> 




Lriented comroandis: -clock- wiXl get the 
fets the (T8-character) HOTie the 
!- get0 the course he isi registered 



ne^ne ^ 
course 

date-* 
write 



$$ vl and v2 for na*e 



vl ;r 

v3 

v4 ^ V ^ ~ ' ' 

Heilol Your natoe is <^a,v1,18)>, ' 
You are registered in <aiV3]^ • - \ 
v The time is "<?a,v4> 
\ V The date is ^a^v5p • 

Suppose the student is registered^ as ^'sam nottingham*' in a coursj^ "£):ench4*^« . 
It is 1jJ:45:37PH (22:45:37 on a 24-h6ur clock) on. June 3^ 1 974 w / The student 
will receive this display;. \^ 

■■■ ; - - Hello! Your name is samWttin^am. 

^ You are registered in frepch4. V 

The time is 22,45, 37. \ ' \ 
The date is JJ6/JJ3/74. 

All of these commands, -name^, -course-^^ -clcick-, cux< 
the requested character string in 'the specif ied^ vsirl 
^showa-. - 



ring , The^re is a system 

which may be used in calciilatidnal expressions: it holds 




-^at^-i simply piiiae 
e f or TJse An *a 



le -clock-* command produces a character 
var iabjtfe^J' c lock " 

the n\unl>$N:;tf seconds of a daily clock to the nearest thousandth of a second • 



It is cdnvenxSnt^for. calculating the amount of time spent in ai^ section of a^ 



lesson. 



\ 



The -da te^ command produces a character string . The rday-\coi 
produces a number cprresppnding to the number* of days elapsed sine 
January 1 , 1973 . /ftis number of days and fraction o^ a day is a^6i 
one^t^nth of a second* i V 

^ " ' ' . ■ , . . ':"'>v ■■ . ■ • 

\ ^ The ^TUTOR judging ^oinminds of f er a grect^ deal pf power* We ^ 
th^ the jiadging commands -bump- and -put- together with the regula: 
oriented comman^^ -move-^ -securch-, and -pack- can be tised^^^^t 
ot]^$a^i^e intractable response into a form which ci(n be h^niSled witl 
judging commands. ^ This is a useful %cheme'a^ 
ar4 required. However > if major modifications of the reslx:tnse^£^ 
in order to be. able to use TUTOR judging J^ilities> it is 
to "do your own judging". That ia# just get the student *s response 
-storea- iandUtieri analyze it with, string-o^rient^d compfgrndai togethfer4wslth\the 
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additional calculc 
even want to use 



|:ional. machinery described /in ciiapter IX, Vpu might not 
. v^vw** — p..ie built-in marker features of the -arrow- Command, With 

the associated r^urns to the -arrdw- when there is a "no" jucigment- kn 
such circumstances you ^night write a subroutine to be used in^place cf\ 
-arrow-* comma^jds, which merely collects^ the student ^s respons^: 



unit 
arrow 
stor^ 
specs 
ok\ 
endarrojw 

Instead of writing 
therh^wr^e 



arrow (apji 
apos 

sstr , sc/it <3= jcount 
nookno , 




arrow 1815*' with associated judgihg (^ommcaids you woul^d 



do . ayrowdSIS) ^ 
calc^moveietc^ to dp your own judging 



/ 



, Naturally this 
analysse* response 
responses which 



irsd of action inadvisable only ifvyoU are trying to 
which have a form very/differe^it fiopm thpse classes of 
ban be handled well by "^JUTOR judging coinmahd^v 



Catching eveacy/kgy; -pause*-, ,-key t^e/- , and -group- 

Somet^imesJ it is useful to process individual keypresses without waiting 
for a NEXT key. We haye already di^i^ussed such typical 6xam^ as moving 
a cursor and/choosing a topic from an index. These examples used a "long* 
with an -arrow- in otder to catch each keypress. ^ There is janother way ^o 'do 
this,- involving the\ -pause- cbiraneind which was introduced in ct^pter II in^. 
connection wiiJli crea^ displays, particularly timed animations^ As was 
pointed out in the discussion' of the key- command in\the present chapter, 
the system/ variable "ke^" contain^ a number corresponding to the most recent, 
key pressed by the student, ^pr example, if the student presses the ' \ 
O^tter "d?, the system variable ^^key" will have the nMmerical vaiue^4 (sirtpe 
d is the /4th letter in the' alphabet) • Putting these notions together, /we ' 
have the/ fOllQwing* kind of structure: 



1" 



write Press '*d!', please, 
pause 

writec key^4,You didn*^ 

.■ ■ ' . ' 7 



d. ,Gopd! 



9. 
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The blank -pause- statement ("blank" in the. sense- of haying no tag) causes 
TUTOR to wait for the student 1:0 press a k^y. Any key will cause TUTOR to 
move past the -pau^e- to the next statement. 

In the ex^ple shown, the -^pause- is followed by A -writec- conditional 
on "keyii^4". Thijs -writec- can be written in more readajble form by replacing 
the "M" by "d": v . - . \ . 

< writec * key54"d", You didn't press d., Good! 

Enclosing the d with (double) qiibte marks^ is taken in cajkculatfbnal expressions 
to mean the numbei^ 4. Similarly, (v30^"z") will assign the valufe 26 to v3. . 
If this student piresses jJ or 1, "key" will have the numerical value 27 or 28 ♦ 
respectively.' 'Hiat is,, the 26 letters are followed by the numbers 0 through^ 
9,^ then come various punctuation marks. - If the student presses the plus 
key, "Hey" will have the' nyimerical Vfeilue which happens to b^ 37. If the 
student presses a capijbal D, "key" -wiH have the value 64+"d", or 68. The 
shifted or upper case letters have "key" value "^4 greater than the corresponding 
lower-case letters. Caution: some common keys auch as parentheses have key 
numbers sraialler tljan j64 despite requiring the' shift key to type them. The 
most commonly used pharacters (lowjsr-case letters, numbers, and common v 
punctuation marks) have key numbers less than 64," independent of whether they 
are t.yped using the shift key. As for the function Keyd (I^EXT, BACK, MELP1, 
etc.), we already saw in connection with the -j key ^ command thkt the correspond- 
ing key numbers aire given by next, back, help.1 , etc.,^jB in ^ 



\^ 1 _ 9otcf key*heIJ>1**,yes,no* 



r 

/ 



■ - - . ^ 

No-quote marks are used for the function keys. ' , 



A more convenient way to determine which key has been pressed is to 
use a -keytype- command. Consider a cursor-moving procedure : 



define num=v5,x=«v1 ,y=v2,dx=l0,dy=14 

unit cursor 

pause < 

keytype num,d,e,w,q,a,z,x^,c ^ 

goto num, cursor, X ' { 

: ' ' V 

calcs num-^ y <!=y i y+dy Tyrhay , y+dy , y , jj-dy , y-dy , y-dy 



The -keytype- command searches through the listed keys (d, e, w, q, a, z, 
X, an4 c^in tihis case) and, similar to the -match- command^> s6ts "num" tOv.--.le 
^ ■' if the key^'is not found in this list, or to 0, 1, 2, 3, etc., if it is ^ 

' found. If the student presses d, "num" will b^ set to JJ; if he presses c, 

"num"\will be 7; and if he presses D, ^'nuttv" T^ill be set to -1. The -^oto- 
' . statentent effectively causes all u^^isted keys to be ignored. 



.7 . . , ^ 
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• Jjs rJote that no quote marks- are Used ;fnv> specifying keys in a -key type- . 
command. Capital letters and function keys may also b^^ listeld: 

keytype v3;a,A,b,B>next,data,timeup , 

- .. ■ . ''■■ ■^ ^ ■ ' ' ■ . ^ 

^fhile the -key type- command is most often used in conjunction with a- -paijse- 
coiranand, it can be used in , association with an -arrow- CQOTiand or any time 
thait you want to decide what key was pressed most recently. The function 
key timeup is one generated by TUTOR when a timing key is "pressed" as * . 
the result of an earlier -time- command (see chapter II) . , " ^ 

Just as the -list- cbmmand Cj^n-be used to specify a set of synonomous > 

words arid numbers for use in --Shswer- and -match- ^ so there is a -group- ; 

command available for specifying synonomous keys for us^ in a -keytype*?^ • * 
coinmand-(/. ' .- _ - ■ , ' .. 

define keynum=v2^algkeys=v24 " - * 

^ gjcoup : algebravx,y>^ ' j ;;v / \ 



keytype keynuih, a, b, algebra, help * 

■ . . -i i i i : ■ 

If the student presses any of tl\e keys x, y,^r the variable "keynqm" 
will be assigned the valu^ 2, An additional -keytype- command can be used 
to separate members qf a "group: ''^ ^ ' ^ 

rkeytype keynum, a, b, algebra, help ^ / 
/ goto keynum,none,ua,ub,alg,somehelp , 



unit alg 

Keytype 'algkey,x,y',z 



Some particularly useful -group-' def initions are built- in",^^ Without specifying 
them with your own -group- command^, you can in ^'^-keytyp^'*- Copland refer, n 
to these groups; ^ . . ! - 



^ alpha 

numeric 
f urict 



all 52 lower-case and upper-case letters 

through 9' / * 
funbstlon keys (next,.help,etc. ). ^ 



P 
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An example of the use of these built-in groups might be 

•keytype .v45iivinct,ajb,c"% You can also use previously defined or built-in 
'groups iiii defining new groups; - 

groups iftinf^^a,b#CL,hi3j& ♦ \ ^ 

group ^ws, mine, d,e,j^ . * 

gfcoUjp^^^ll , A , B ,C>otfr ^numeric , f unct v "7 

it is imporlant to n6te that if you use a -pause**, the key pressed will 
not cause the a^ssQciated character to appear on the Student *s scri^en. You 
are in complete control. You may write something on the screen or not, as' 
you choose . 0nly if you Ufisp an -accrow;; will* the standard key display take 
place, with the associated ERASE and other s4fandard typing features elvaj»labl 
Similarly, if you (press HELP.^ you will not automatically brancjti to a unit 
specified by a previous -help- command; because a blank -pause- g^^s you 
every key, function key or not; ^ i. 




There is a variant x>f the.-pauQje- 'comniand which is usualljr'Tfioiire useful 
than the blank -p^use-. You can. define wl\icl2.keys Me to be accepted, and 
all other keys will be i-gnoredj /-^^^ 



^ nfxt. umore 

. h61p discuss 

data tables. " , • 

- - ■ ^ '\ ■ V 



j^use keys'=d,D, next, term, help, help 1 



''Any key not listei(i chere is completely ignored, as though the student had 
not pressed it. .Of the function keys listed, th^ HELP key will tsike the 
student ta>unit "discuss'S since ypu have already specified what you wa|it 
the HELP to do. Note that this is not possible with a blank -pause- 
which catches all keys. Similarly 4 what the T]|HM key will do has been 
predefinedl:^ the atudent will be «iked "what ^etm?" But the DATA key will 
be ignore|i 'since it is not listed in the -pause- statement, and the student 
canhpt re^ch unit "tables" with the DATA' key until he has passed the -pause 
Pressing ^, D, NEXT, or- HELM will take the student past the -pause-. The 
NEKT key is slightly special here in that the preceeding specif icatiori 
"ne^ /uittore"* linlike "help discuss'% tells TUTOR what to do wh6n theo 
present;, i^in unit^has been completed . Thus pr^ssin^ NEX^T here just takes us 
past the >^pause- father than branching us immediately to a different unit 
as HELP jdoes. . • . * " * 
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If you want tho HELP key not to be ignored but not to accesa unit 
discuss , the statement "help discuss" must follow the -pause- state- 

rSV^nit """""^^^ ^""^ ^° .pecifying 



Summary 

TlvLs chapter has demonstrated an array of techniques for judging 

°5 responses.^ There are -ans*wer- and, -wrong- (aided 

W -list-} for handling sentences composed from a rather small vocabu'iary 

-concept- (supported by^ -vocabs-) to handle dialogs 
S ^^mifv T y°°^"l'»'^- The -match- and -storen- commands can be • 

\1 out pieces of a student's response. There are -ansv-, 

-wrortgv^, -ansu-, and -wrongu-, aided by "define -student", for judging^ 

K^'^.f^r^f*^" responses. Thfe -exact- and -exactc- commands can 
be use<^hen it is important that the response take particular precis* 
„?^U'm,o ! -specs- command permits you to- control various options associated 
with these commands and also provides a convenient marker o% centralized • 
post-3udging processing. The regular -judge- command offers additional 
trSLrr judging/process. The -bump- and -put- commands can be t.sed 
to change a ftudenfs r^spons§ into a form more easily handled by the 
standard judging commax/ds. The -j key- command can be used to cause ju^iging 
Sn^n^ f ^^^^^ ^" pressed. The construction of 

randomized drills was illustrated, vith the use of -^etperm-, randp-. ' • 
-remove-, and -modperm-. ' i- » « i- » 

• ■ ' ■ » ^ "» ■ ^ 

■ . . - - 

You have also seen how to store ipneric and alplfehumeric Responses ror 
- later processing (-store-^ And, -storea-) . These capabilit|.es make it pq^ble 

no/°"^^°J!f ^ It'^K ""^"^^ "^"^ standard judging commands 

are not suitable. • Th^ basic TUTOR judging commands provide a g^eat deal 

alwav?^^^''^K^?^'*^^ situations. ,Fortun^teS there i^ 

always, the possibility . of performing calclitions on stored student" respons 
"""^l "^T in its judging power-. Se reguS?^ 

commands -search- anS -move- cah^ be used to man!p\ilate st<ired ^characte,^ 
strings, (in cliapter ix you will find discussions of "segments" and"^bit \ 

"hich.permit you to use the -calc- .corfSriand to p6rfS additional 
?rorS° character strings.) We also discussed how to hkndlE input . ^ 

-kevtiSo ^ulT^ l"" collecting each key with a -pause- tjomkand, theh using 
-keytype- (aided by -group-) to makd decisions on a key-by-key basis. ' ' 

• ' . - ... . / 

™ ^^lu ^^^"^^^^^ in some detail the marker properties of -the -arrow-/- 
command The -arrow- , command ^Bves as an anchor point which TUTOR "clings 
to until the -arrow- is satisfied by an "ok" ja&gment, at which "point a 

Svo^viiS Jf' ti°n^i.-^~W"X°"^'^^' «^ ^t soL cases • 

Satel Lfof'S?"'! of -j^-'i„ regular, judging, and search 

w! f v i J noi-execution of -goto- in the judging and-search states. • 

We also looked at otijr Side-effects of 'the -arrow- Command, including initial- 
izations associated- w^th -size-, iirptate-, -long-, -jkey-, ^'d -copy"!* ' 
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It im plumed that TUTOR have additional Judging capabilitica added 
to it in the future. One major in^toveiaent is inninents the uae of multi- 
wrd "phrases'' such as '•Santa Maria'* and '•out of order** in -^answer- and 
related eoomands. Such phrases viould be handled essentially as though t;hey 
were single words. This turns out to be extremely useful in Judging sentences 
correctly. This phrase feature is now available in -vocabs- but has not - 
yet been extended to the othei;: word-oriented TUTOR machinery. 

It is hoped thi^t you will re-read this ch2ff>ter occasionally in the 
course of writing curriculum materials. The TUTOR Judging capabilities are 
extremely rich because of the wide range of student responses that muat be 
handled properly for lesson material to be successful. You should dip into 
this chapter occasionally as your own work suggests questions as to how to 
Judge various classes of responses. Dp not feel unhappy thttt some aspects 
of judging aren't clear to you at this time. Just be sure to reread 
appropriate sections of this chapter at a later- time, when you need the 
* details, fox now it is sufficient to kpow what is available, and roughly 
in what form. 
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VIII. Additional disftlai^ features 



\ 



More on the ^wyite^ coinmand 



It should be pointed out that the -at- Gommand not only specifies a 
screen position for subsequent, writing, but also establishes a 'left margin 
for "carriage returns" (CR on the keyset)' in emalogy to a'tyjfewriter. Upon 
completion of one liije of text, the n^t line will start at the left margin 
set by the last -at- command. There are carriage returns implicit in 
"continued" write statements: 1 • 



at ' 
write 



1215 

Now is the 
time for all 
good men to 
come l^ome* 



Thq "at . 1215" establishes a left margin at the \l 5th character position 
so that each line will start there. This example will produce an aligned 
screen display/ similar to the appearance of \bhe tags \ of this continued -write- 
statement« 

■ ' "'v ^ 

The setting of a margin by -at- has an unusdal slide effect. Consider: 



at ; 2163\ 

write 1 The cow- jumped. 



This will put the following 



ing^^tjs]b] 



lay on the screen: 



\ 




Th 4 
e 

CO 

w 

ju 
' mp 
ed 



This"3tSLdue to the left* margin at charaq^e/^qsitioh 63, just two characters 
shy of t!fe right edge of the screen. When a -w4^e- wpuld go past the right 
edge of the screen, TUTOR performs a carriage retiiKn^to Hrpp down one line, 
starting at the left marrgin. An -arrow- also sets a^ieft margin with respecfe 
to the student tj^ing a long response which jwould pass the right edge of the 
screen^* further typing appears on the next lower line st^rtijig at the margin 
set by -arrow-^. 
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ijt is imflfbrtanF^'^qunder stand that! writing characters ^n the screen 
autoinatically advances the terminal's current screen i?osition.\ Suppose. we 
have (Consecutive -write- stk4;gments: 

at 712 • V ' 

write hojTses ; 
write cmd cows 

TJfiis^ sequence will display "horsesand cows" all on line 7. The f irst -write- 
j("horses"^ advances the t^rsnodnal's screen position from the 712 specified by • 
the preceding -at- tq 712+6^T>at there being 6 characters in the text "horses^ • 
Without an explicit -at- to change ^this, the second -write- ("and cows") 
starts at position 718. Note that 



at 712/. 
write hcijj^es 

«and cows 

would give a different display: 

horses^ \ 
and .caws 



because the "dontinued" -write- stat^ent impli' 



^nenl 



car^^i^ 



iage returns. 



TufrpR keepa track of the current screen position in a system variable 
named "where". For example, ^ ^ , • 



\ 



at 7AZ 

write horses . 

at where+3jy5 

, jwr ifee>v and cows 



$$ *wher.e" is 712+6=718 here 




where 



Vand cows 



where+3Jl}5 



will produce the display 

horses 
3 lines > 

5 characters 

The statement "write horses" leaves the screen position at 712+6=718, and the 
system variable "where" therefore has the value 718. When you then say "at 
where+3ja5'' this is equivalent to saying "at 718+3*f5" or "at 1023". 

\ 
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\ . 



/ 



lere are many uses of this "where" system variable. Here-is another 
example: 



/ 



at * 1215v 

writye Whatvls your name? 
arrow where+3 



ThiU^ill appear as 

What is^our name? ^ Sam^ ' , 

The arrow 1 has been positioned 3 characters beyond the end of the -write- 
statement'fe display. . ' \ 

The jfi^ositioning ^jlormation is useful wi\h other display commands as. 
well. . Consider this: ^ ^ 

at 8^5 
write Loiak at this I 
draw where; 81 5 

This will display underlined text: 

Look at this! 

\ 

This is due to the fact that! upon compl^ion of the -write- statement "where'' 
refers to the beginning of the next character posaJtion, just after the excla- 
mation point. We simply draw from there, back to the starting point. This 
form of the -d3faw- 9tatement jjLs so common that a concise form is petmitted^: 
"draw. ;815" is equivalent Ito "draw where; 81 5". Eithet 'form will draW 
a line or figure starVin^at [the current screen position. This is particular] 
.useful in constructing^ 9^PM connecting the new point tdi the last point v 
with a line. The point fceaMikd with a -draw- (or an^ dijsplayXcommand) will 
be the new screen position ami may be referred to through the sysrbem variable 
"where". Which is k^pt up to da^^&^^^^omatic^ by TUTOR. 

There are fine-grid system variabies "wherex" and "wherey" whieb^ correspqjnd 
exactly to the coarse-grid "wheiffe^^ The position "where+305" is equi 
to "wherex+ 1^x8) , wherey- (3X16)" bedauae a character space is 8 dots wide^nd 
16 dots hi^. The miftUs sign is prjesehfc because in coarse grid line 4 is 
below line 3,, whereas in fine grid dot 472 ±^ above ^ot 471. 

Superscripts and subscripts may be typed either., iii a\4x>cking or non- 
locking mode. ^ To type "1023" y^^^ either '(a) prbss 1, p^s 0, press ' 
SUPER, press 2, press SUPER, press 3 (non- locking case) or/ (b)\press. 1, 
press 0, press sbif t- SUPER (thqit is, Jiold down the shift key whil:e pressing 
SUPER), press 2, press -3. To get down from a locked superscript y^. type 
shift-SUB (locking subscript) . Notice l^at in typing superscripts 'or\sub- 
scripts the SUPER and SUB keys are pressed and released before typing the 
material to b^ moved up or down; you do not hold these keys down while tyj^ng, 
unlike the shift key used f Or making capital letters. *\ 
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^ It is possible to overstrike characters to inake cotnbinations. The 
synjbol "v" can be n^de.by typing v, badkspace; SUPER, minus sign. This 
will superimpose a raised minus sign abotre the v. The backspace is typed 
holding down the. shift key while hitting* the wide space bar at the bottom 
of the keyset. Similarly, ^' horse " c«m be tj^^ by typing 2horse" followed 
by five backspaces emd five Underline characters. Note that these super- 
positions of characters won't ynotVi in "mode rewrite" > where. a new character. 

^s written on the screen. In mode rewrite the last exaonple^wpuld sK^w up 
as*^" ", the "horse" having been wiped out by the' characters whose. only 
visible dots are the lOw, horizontal bars. ' ^' * , •'^ ' , 



Extensions to the basic character set 



We've se^ examples of lower-case emd upper-case characters, ijumbers, 
punctuation marks, superscripts, and subscripts. What if -you need speqial 
accent marks, or an unusual mathematical synOx)!, or the entire Cyrillic 
alphabet for writing Russian? It is importeint that you be able to write - 
text on the screen using the special symbols of youi: particular subject area* 
In. addition, it is possible td use special characters to display sm^ll, 
intricate figures whose display would be slow and cumbersome if don^ with * - 
-draw- commands. ^ 



The PIATO terminal\^Jias 126 built-in characters (including those used so 
far) and storage for 126 Wditional characters which , can be different in 
every lesson. For example^; Russian lessons fill this additional character 
storage space with the Cyrillic alphabet, whereas there is a genetics lesson 
which fills the storage arefi^ with fruitfly parts. which permit displaying 
flies Hyjwriting apptiopr iateXcharacters at appropriate positions on the 
screen. We will learh how to\iccess all 252 ahar^cters—^those built-in and. 
those which can be' varied. 



The 126 built-in [characters include many useful symbols which do notj ap- 
pear on the keyset, because there arep't enough keysj This is due to^thej 
fact that the keys on the right of me keyset are reserved for various iWr 
portant functions (ERASE, BACK, STOP X etc.). In order to access the "hidden"^ 
characters it is necessai^y to first, strike theACCES? key * (presently . the ' ^ 
shift-D key) and theni to strike a second liey. Likfe-SUPm^ and. SU^, the 
ACCESS key is not held down but". stpuck. xYou can pres% >\CCESS, •then "a" 
to get' a Greek alpha; ACCESS- "b"- Iof betk; ACCESS-'''m" for mu; ACCESSV=" 
for "?^"; ACCESS-"<" or ">" for ?'^" or "^".^ At a terminal it is useful 
to try ACCESS follow^ by every key (or shifted key) -to find about 36 usel 
hidden characters. Luckily in most Cases there is a mnemonic connection 
between the key which follows the ACCESS key and the hidden character .which 
resultisf, such as being ACCBSS-"*»". ACCESS followed by comma gives the 
symbol ♦ mentioned in the discussion of the -writec- command in chapter VI. 
AC^SS-ja and ACCESS- 1 give the symbols <l and > used for ^embedding -show- 
comaiiai|ds in -write- statements^ >^ 
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You ckn gat at the "alternate font" of 126 additional,^ moaifiable 
characters by pressing the FONT key (the shifted MICRO key)^ then typing 
regular keys, which Will produce characters from the alternate font. What 
charapters appear dtpsnds on what character set has been previously loaded , 
into th^ terminal. The FONT key toggles you between the standard built- 
in font and the alternate fonts you stay in the alternate font until you 
strike FONT to return to the st^indard ^ont. It is therefore not necessaury 
to strike FONT for each symbol (unlike the way ACCESS woi^ks) • 

Here is an example of the use of a special character set: 

at 912 

write Now LOADING CHARACTER SE*. . • 

Please be patient - loading ^ . / 

tcikes about 17 seconds, 
chat set standard i russian « . 

erase . $$ full-scre(§n erase to remove message 

unit intro 

write The Russian word KapdHoauu means pencil. • 




The -char set- statemen^^ends to the teirminal the charac£er set specified 
i« the tag (character set ^'standard, russjlan" in this case) . Charitoter ^ 
-pattgrns^re transmitted to the tenninal at a rate , of 7.5 chara6t6r patterns 
per secondT^so^^uii t26-chara6ter set will take dbout 17 Seconds ' ta s^nd. ^ 
Precede the -charset- command with a -write- statement to explain ^hi's delay 
\to the student; otherwise he will think something is broken 1 ^The full- screen 
^rase-* will remove the message Aipon completion of theXLoading process. 
Once th^^ qhciracter patterns haveAb^en loaded into the terminal it is possible 
to\«rite Hussi^ari text on the student's sci&een at th^ s^e^igh speed as 
English I 18/^ cliaracter per second^ which corresponds to a reading speed of 
almos^ two t^ouscind words per minute. ^ \ . 

JTOR kd^ps t^clc^of which character set has been loa'cied into the terminal 
and skips a -char set*i>^^ statement if loading is not required, tn the above 
example TUTOR would \ush^ight through the message, skipping the -char set-, , 
cind erasing the screenv There would not be the 17- second delay which occurs . 
^ if the Cyrillic characters have not been loaded.' 

The -write- statement ih unit "ii|tro" is created by: 
1 . typing "jwrit^ The '^Russian wopti " ; > 
• 2. striking the FONT key to select the alternate font; 
\ ' 3. typing the keys k, a*, t, a, n, d, a$ s (which causes 'HapaHnaui to 
appear); f 
Striking the FONT key to togc^le back to the standard font; 
typing means pencil." 




Each character in the alternate font is associated with a key on the keyset. 
For examplevXthe creators of the "russian" character set cho^e to associate * 
the Cyrillic '"^^with the "d" key because of the phonetic similarity of these 
two letters. Similarly, the Cyrillic "p" and "h" sound like the "r" and "n" 
letters with whose keys they are associated. Just a& accessing ^soMe of the 



y 
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126 builtrin ohzuracters requires the ACCESS key, sd a full 126-character 
alternate ^^font will also necessitate the use of the ACCESS key to reach some 
of the characters. • * 

* ' •. ■ ' \ •' . . ■ '• \" 

*lf the student is to respond at an -arrow- with a l^ussian response, he 
mudt hit the FONT key in ordep to do so; Usually it is preferable to precede 
the first judging command with the statement "force font" which essentially 
hits the PONT key for the student. He merely uses the regular typing keysj 
but his typing appears in the alternate font, ^ . 

The "initial entry unit"**-ieu 

You may have noticed that the first few statements of the previous example > 
(which write a message, load^ character set, and then erase the screen) are ^ ^ 
not preceded by a -unit- stateme|vt. This is intentional, TUTOR statements ^ 
which predede the first -unit- st^il^ment ("unit intro" in this case) consti- % 
tute an "initial entry unit" whicb performed whenever a student enters the 
lesson, The "initial entry unit" ("ieU" for ^hort) is the logical place to 
put various kinds of initializationsv^^^h aa a -charset*^ statement to load 
characters which will be used throuo^out the lesson. Although -define-, 
•^vocabs-* and -list- statements are not actually executed pjtfafey- are only . 
instructions to TUTOR on how to interpret -calc-, -concept- i eind -answer- * 
statements in preparing a lesson for student use) they can be placscT in the 
"ieu"; they do belong at the beginning of the lesson fojp the sake of read- 
ability, 

■ A . ■ . ' . 

The importance of the "ieu" lies in the fact that it is performed no - ^ 
matter where the student 'starts in the lesson — even if he- does not start at 
the first unit statement, A student who leaves without finishing a lesson 
will restart the next day where he left off because TUTOR keeps track of * . 

where ^ he w^s when he left. It is important in restarting to load the ap- 
propriate character set, which would not be accomplished if the -charset- 
statement came' after the first -unit- statement since the student will not 
go tjirough this first unit in restarting where he left off, - 

Suppose the jitudent is to restart in unit "middle", which looks like 

this: 



. - , uni;t middle 

next mid2^. 

The way in which the '^ieu" is tibilized is that TUTOR acts as though the ieu 
were done at the beginning of the^sfestarl^ unit: 

'» ' • 

^ . unit middle ' >"i 

(do "ieu") ' ^ 

* next mid2 

■ ■* • ' ' » 

Th^gLs pseudo-do is the reason for following the -charset- ^statement with a 
full-screen erase. We don't want the "loading" message to mess Aip the dis- 
play created by unit "middle". 
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Smooth animations using special characterg * * ^ 

'•' i' ' •* ■ - - 

, The -charset- qony[nai\d ^is nb^ liml£ed to it8 use with foreign alphabets. 
Special characters are *pf teit ui^ed* to. create pictured: 

'at \ 1319 ... 
write This y^^i ua^z: —-r.iai nhrir-ct^rsl 

* '' J* * ' ■ *' 

^The car is composed of several adjacenjt KQiaracte^s. Because characters chn 
^ be drawn very fast (18^ per second) dx^unatic animations are possible: 

• • • ?(wxle rewrite ^ - , 

dQ drive,x 0^100, 400 ^ ^ 

unit drive ^ 
o at x,20JJ 

write ' ^ ^ \ ^ ' , • 

The car advances one dot at a tiine. If t^^e car ^chciract|ers are desighed in^ 
* such a wa^ as to leave a vertical column* of blanK dots at ^e back of the 
car, the "rewrite" mode will insure that the advancing car siAiul'taneousl^ 
erases its old position. If two columns are left blank the car cou^^cL^e 
advanced two, dots at a time ^nd still completely wipe out the previous car 
display. This type of anima^tion can rurf as fast as twenty or thirty, moves 
^er second, which creates the^ illusion of a smoothly moving 'object. 

♦ • * - 

For the built-in characters there is an expandable and rot a table but 
slow line-drawn form available through the use tDf -size- and -rotate-, but 
these commands have jio effect on text written in the alternate font* If 
a larger or rotated cair is needed it must either be constructed with -draw- 
and -circle- commands or, built up, out of additional special characters. 




Figure 1 demonstrates how a special character is designed at a PLATO 
terminal. The author moves the cursor on an 8 x 16 grid* to specify which 
dots are to be lit. He b^n inspect "i'n the small" the appearance of the 
character he designs "in the large". ^ The letter shown at the top of the' 
page is the key with which this character will be associated when typing in^ 
^ the alternate foAt, just as 'character "c\" is associated with key ^'d" in 
"charset russian". The character pattern is stored in such a way that the 
author can at any later time recall the pattern and modify it. A character 
set can contain up to 126 special charactejrs or as few as one or two characters. 
■ . • ' . ' ' \ 

, Figure 2* shows how an authof can create several 8 x 16 characters at 

' once to be used together or separately « This option is particularly helpful 
when designing character-mode pictures. 

Your own character set will be stored in an electronic storage area 
assigned to you* Such storage areas are called "lesson spaces" because' 
they mainly hold TUTOR statements describing a lesson to be administered 
to Students by PLATO. Your lesson space might be called "italian3" and 
it is by this name that you«^;refer to the lesson space when you want to look 
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4t the TUTOR Bta^emen1i\s oK change them. Within this lesson space you can 
Iso have one\or 



more character setsi which you will haye^named. Suppose 

\n lesson spatiL "italianS" you have stored 'a charabjg^/I«^\named "roine". 
Then the TUTOR\s':atenient used to trari^mit this character set^N^d\a terminal 

*is ' ffl ' \ y . \ I 

\ ' ■ ■ ■ ■ ■ 

char set italian3,rome 

' / • \ 

lesson space character set 



Micro tables "^^-^ " " , ' , V \ 
~ ~ ■ .V ^ ^ ^ 

i V It is sometim^esfdesijrable to associate a string dS^ several characters / 
with a single key. For example, the symbol v may be /pjroduced by v, backspace", \ 
superscript, minus si^. """^^^^ possible to set tip a "micro table" so that 

V ma3{ be produced simply by, hinting the MICRO key followed by hi^tiag^v!!^ 

Similarly, the micro table might s^eqify that MICRO- "e" should be eqiiivalent 

to typing e, shift- SUPER, k, x , SUPER7"^2^^ el«<? . 

The micro" table makes po.ssible a kind of shorthand which" can >e useful * 

both to authors composing -write- statements and to students typing complicated 

responses. • r ' . * 

Like character sets, mifcro tallies 'reside in lesson spaces. If lesson 
space "Italians" contains a micro table named "dante", these micros can be 
made "available to students by the statement 

■ 1 ■ \ ■■■ 

_ ■ . . ' « 

micro it^lian3,dante . * , 

• ■ ■ ■ ■ ' ■ . ■ 

f> ■ j 

As with -charset-, the -micro- statement should be placed, in the "ieu" I 
(initial entry' unit). 

" Figure 3 shows how an author defines an item in a micro table, by - 
associating a string of characters with a particular key. Later the effect 
'of striking MICRO followed by this key is identical to typing this string of, 
•characters.* S , \ 

i • ' ' ■ \ \ ' ' '.' • ■ ^ ^ 

Xf you do not specify your own micro table a standard one is provided . 

that lets you use the MICRO key as thpugh it were the ACCESS key: for 

example, MICRO- "p" gives ACCESS- "p", which 'is tt. This means you can an<^ 

should mention 6nly the MICRO key to students in your typing directions to 

them. It Is not necessary to itienliion ACCPSS. 

■ . ' •■• ■ - ■ \ ' ■ " ' ■ 



The graphing bommands; plotting graphs wiph scaling and labeling 

You may often want to plot a horizontal or vertical bar graph or other 
kind of graph to display relationships. There exists a group of TUTOR 
commands which collectively make it very easy to produce such displays,. In 
particular, scaling of your variables to screfen coordinates is automatic, 
as is the ntamerical labeling, of the axes, with tick ma(^ks along theses. 
Figure 4 shows an example. . 

, ■ ■ ■ • . • . , . ■ / ■ 

* With a "force micro" in effect, the student does not have to press MICRO. 
This makes it isasy to redefine the keyboard. ^ ^ 
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Suppose you waxjt ei gr^ph to occupy the lower half of the scJreen. The r 
horizontal x-axis sJ^ouldUrun from 'zero t^o ten and the vertical y-axis from 
zero to two. Both aKes should be labeled appropriately* These statements 
will xn^e the' display shown: ^ \ / 




unit 




labely 

graph 

g:eaph 

hbar 
a 

vbar 
* 

gdraw 

locate 

write 



$$ x,y origin 
$$ lengths An dots 
$$ maximum x 
$$ ntiaximum y ^ * 

$$ major meurk ev^ry 2, 
minor ^very .5 
:^ $$ major mark every .5 

$.$ x«8| yy. 5 ^ 
$$horizor^al bar to 
3,1.5 ■'/. 
* $$ vertical fiiar to 
^4.5,1 
2,.5;4,1.5;7,f 

Top* 



.5 

6^1.5,A 
8,.5,BC 
3,1.5- 

4.5,1 



After specifying -origin- and -^cixesj-^ in^ terms of fine-grid screen. coordinates 
the -scalex- and -scaley- commands associate scale values with the end points 
of the axes. These scale Values determine how (x,y) coordinate positions 
given in later statements will be scaled to screen coord^inktes. The -labelx- 
and -labely- commands cause numerical labels and tick marks to appeair. The ^ 
statement ^*graph 6, 1.5, A" plots an A at x±=6, y«1,5 in scaled coordinates. 
The -hb^r- ax^ -vbSr-^ commands draw horizontal and verti6ai bars ,to the 
specified scaled points. The -gdraw- command is ^ like -dravifr, except points 
are specified in terms, of scaled quantities. The -locate- coipmand is like 
-at-r but uses scaled quantities. . ^ ' 

Reread the example and ^ try to idehtify in the picture what part of the 
display results from each statement. Of course each number in the tags of 
these statements could have been a complicated mathematical expression. 

The -marloc- and/-marky- commands are similar to -labelx- and r-labely- 
but merely display tick marks without writing numerical labels. The '-axes- 
command has an alte]rnative f orm to allow for axes in the negative directions: 



ERIC 



s 



origin MS0,200 

axes . -5iJ,-1iJiJ,3iJiJ,15)a 



minitniam jK,y 
f ronf orxgin 



maximimi x,y 
from origi^ 




149 



■/:;.. 
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Although, the conunemds were originally vdesigM to imake It easy to 
d^-^w graphs^ the automatic scaling feature;^ make thesiql j^oira^ in 
^many situations. Note in particular that y6u can) mov^ jcomplicated displays 
around on th^er screen merely by 6hanging^;rtaie V^rigin- statement.;* • 

Additional graphing qomihands include -v<lctoi:- fbr/ drawing a line with 
an arrowhead at one end; -polar- f or poldr coordinates jf -Iscailex- and -•Iscaley 
for logarithmic scales; and -funct- and -delt^-v for plotting functions. 
The -bounds-^ command haa the same effect as -axes- ini establishing lengths, ' 
but no axes are drawn oh the screen. The -fra^e- com^ is used to draw * 
rectangular boxes easily. i \ / ^ 

. V- " ■■ . . ■ . . .• V : ' • . 

Summary of line^^drawing commands^: -draw-^ "^^ydraw-., Hrdraw- ' • 

Recall that the -draw- statement has the form ; , 

• ' ■ ■ ■ , . . ^ . . . • , ' i' . ^ ^ ."^ . 

^ draw point 1 ; point 2 ;po in t3> etc. > " . 

where eaclj pojnt may be co^rse^grid (such as "r215'|) or fine-^grid (sOch as 
"1*35,245") // Each point specification is set c>lf byf a Semicolon in order to 
avoid ambiguities when mixing coarse-grid and fine-Wrid points, as in 
"draw ,1525;1932;35,120;1525" (the first two po:^njts are given in coarse-' 
grid} the third, in fine-grid; and the last point ih coarse-grid coordinates) . 

A discontinuous line drawing can be made with single -draw- statement 
by using the word "skip"^ 

diraW I518;l5l38;skip;l738;l7l8 

Using "skip" in a -draw- statement mea^is "skip to'i:M*^nixt point without 
drawing a line. •* This example is essentially equivalent to - . ' 

draw 1S18;1538 * . 

draw 17381^1718 

The only difference between these otherwise equivalent fojnns is related *to 
the fact that ttfe system variables "wher^", "wherex", aiflid "wherey" are not 
Brought up to date until the completion of the -draw- statement. The sequence 

at 1319 $$ Bf fee ts "where" * 

draw *151J3; 1538; skip* 1738| where 

is equivklent to ^ - " . ^ • > 

^ ■ . * ' .• ' ' ■ 

i at ' 1319 " • . . 

. draw 1518;1538 

draw 1738; 1319 



r 
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' since during the -draw- statement 5'where" has the value 1319. On the- other 
hand, the sequence 

at 1319 r • . * 

draw 1518; 1538 \ 
\ draw 1738? where • . ^ 

is equivalent to \ ' ^ 

at 1319 ' • • ■ . * ' 

draw "1518; 1538 . . \. 

draw 1738; 1538 • . , ' 

^ . , * • 

since nrnn /rnmrlrtinTT^inf ttr fir-f -draw- statement, the value af "where" 
• is 1538. This difference ^lebil^n ^ single -draw- using "skip" and separate 
-dMW- statements is sometimes^l|geful in drawing figures relative to some 
point. 

As mentioned earlier, starting^l^th a semicolon implies a continued 
\- drawing from the present screen location: 

at. - \1319 
draw ifj 542; 1942 ^ 

• jls equivalent to 

at 1319 
draw. where; 1542; 1942 

; or ''draw 1319; 1542> 1942". 

. Sometimes you . have more ppinti^^for a -draw-" than will fit on one lil 
A "continued" -dfav/- can be written, with the commemd blank oh succeeding 
lines: * • ^, 

•• - \ ■ ' • ■ ' 

draw 1512;1542;skip;liJiJ,2jJiJ; . . 

40li,2SSSS}Afl0',4lSlS; ■ ' . 

This will behave asJihough all the points had beeii listed on one line. . 

To summarize, the! -draw- statement contains fine-grid* or coarse-grid 
^ points separated by sejnicolons; "skip" can be used for a 4is6ontihuous 
drawing; "where" and the fine-grid "wherdx* And "wherey" are brought up to 
date upon completion of €he -difaw-; and starting ^he; tag with a Semicolon 
has the .special meaning of continuing a drawing froirf, the present screen • 
position. V o \. ^ / 
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The «gdraw« coironemd ia like the -draw- coimumd except that points are 
relative to the graphing cQprdinate system established l^y -origin-, -2uces-« 
(or 4-bouhd8-), -scalex-, and ••sce^ley.- (or iogeitiUvnic scales set up by ' 
-l«calex- and -Iscaley-),^ Of particular value eu:e the^skip" optio|i and 
starting with a semicoloii for continuing a drawing. The us^ of "where" 
"wherex", and "wherey" in a -gdraw- statoroent is normally not meaningful, 
since these system variables refer to the absolute screen coordinate system, 
not the graphing system. In the gfiapking coordinate system^ there are only 
fine-grid, not coarse-grid points, s?S^all points have the form "x,y". 

It is possible to use -draw- to draw something relative to 'the present 
screen Irasition: , , 

draw wherex+25,wherey-75;wherex+2/JjJ,wherey+15iS „ n 

(Remember that "wherex" and "wherey" do not change until the coriipletion of 
the -draw- statement.) There is an -rdraw- command (^'r" for "relative^) 
which makes such. drawings simpler. The ^ample just^shbwn can be written 

> . . ' ' ' '' ■ 

.rdraw,, 25,-75j2^?jj;i5/J " \ 

Each point is taken to be Irelative to the present screen position, which 
is referred to in an -rdraw- as the point 0,0 (wherex<t-0,wherey<l-0) . Each 
-rdraw- statement skips back to 0/0 so that another -rdraw- can be performed 
relative to the original screen position. It is as though you had written 

' ■ ft ' , * 

rdri^w 25,-75;'200,150;skipj0,0 

to get back to the relative origin. Note that this is different from the 
behavior of the -draw- command. Which leaves you at the last point drawn' 
to* 

The -rdraw- command is particularly useful for applications such as 
writing the s^e Chinese characters at different places on the screen. For 
each Character, make a subroutine involving one or more -rdraw- statements. 
The characters tcan be positioned with -at- statements; 

at 400,400 

do chini 

at 400,300 

do chin2 

etc. 

Or you might include the -at 

do chini (400,400) 

do chin2 (400,300) 



statement in the character subroutines: 



vm - 13 



In this case each subroutine "has a form like this: 

^ unit chini (a|b) 

• at a,b 

rdraw -»75,3iJ;75,3/l;etc.^ 

Unlike -drav^-i the -r^aw- command is affected by preced(lng -sisii- 
and -rotate- commands. | Your Chinese characters cem be enlargtfSTand rotated: 

size 3.5 \ $$3.5 time normal size 

rotate 45 \ $$ 45 decrees 

' \do ' chinKWiW) 

^ao chin5(4M, 3)9)9) 

Figvire 5 shows- a design created with the following commemdss 

do f igure, a 36/9,15 

*" . . " ■ - , • ■ 

unit figure 
rotate a 

rdraw ^ ^-50,0,50 ,fl90»200;'50,fi - \^ 

,The ^rotalfe- command affectsi -rdraw- even with "size |f", even though 
-write- is not rotated in size 0. This is done to faclfttate normal text 
operations « As far as -rdraw- is concerned , size 0 is equivalent to sise 1. 
As far as -write- is concerned, size 0 means "write text at ^60 chwacters 
per second, unrotated", whereas size 1 meeuis '^writQ line-drawn text at 6 
characters per second, rotated**. 

Note that -rdraw- and -size- are essentially reciprocal to -gdraw-'* 
an4 -scalex-. Xn the case of -rdraw- a drawing gets bigger when -size- ^ 
specifies a larger size. But specifying a larger number in a -scalex- 
command implies that the same number of screen dots (given by -axes-) 
will now co:c;respond to larger (scaled) numbers in a -gdraw-* This me2Ufi8 
«that a larger -sc^ex- implies a smaller -gdraw- figure. Note that -origin- 
affects -gdraw- the same way that -at- affects -rdraw-. 

While -scalex- and -scaley- permit you to scale -gdraw- differently 
in the horizontal and vertical directions, it is not ^^^et possible to specify 
both an x-size euid a y-9ize for -rdraw-. On the other hand/ -rdj^aw- can be 
rotated, but there is not yet a -grotate- command for rotating a -gdraw-. - 
It is possible that these missing features will eventually be added to TUTQ^ 
Similarly, there may become available an -rcircle- affected by -size- cind 
-rotate- and a -gcircle- affected by -scalex- and -scaley-. \ 
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The "Windoi^* command ^ 

Sometimes it is useful to specify a **window** through which drawings 
are viewed. Peurts of a figure 'extending outside the window are not drawn • 
A rectangular wiiteow is specified by giving the lower left and upper right 
corners of the desired window: ^ 

window m,2M,mi}M 



lower *left uppe? right 

Tljie corners could also be given in*coarse**grid coordinates i As in 
"window 1524,1248". 

Drawings constructed -frcMn the various -draw^ comroands and -circle- 
comnands are affected by a preceding -window- command. Line^dr awn text ^ 
(size non-zero) produced by -write-, -writec-, -show-, etc., will also be 
windowed. Like -size- and -rotate-, windowing is not reset upon entering v 
a new main unit. BE SURE to use a blank -window- coitpand (blank tag) 
to turn windowing operatl&ns. A very common error is to forget to turn 
off windowing and then wonder why Some of the drawings aren't showing up! 
The correct structure is * 



window lower left corner, upper right corner 



windowed display statements 




^1 
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More on er aging; the ^-eraseu" comnemd 



•no" or "wrong", he can correct 



^ ' * When a student's response Is judged 
his response by hitting ERASE or ERASE 1 to erase a letter or word # or by 
hitting NEXT, EDIT, or E0IT1 to erase the entire response. If additional 
judging keys have been defined with a -jkey* conmiand, these will act like 
NEXl^ and erase the response. If there is only one «arrow«- command and no 
-endaurrow-, these options are available even after an "ok" judgment, except 
that a NEXT key or other * judging-toy takes the student to the next main 
unit rather than merely erasing the response. ■ \^ , > 



If the student erases part or all of his response, the "ok" ox "no" 



is erased. Moreover, \the last response^ 
is erased, since it is\ no longfgr relevant^. 



4ngent messacfe to the student 
For examples 



wrong cat 

write The cat is 

not a canine. 



The student types "cat" and presses NEXT: 



^ c^t 



no 



JThe cat is 
nog a canine, 




If* K 
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Notice that there is a default -at- three lines below the response, 
the stu^nt now presses ERASE: 



Suppose 







\ 


^ ca 
















• ^^^^^^ 




Phe "t*S the "no", and the text o*f the -write- statementXha^^ all disappeared 
atitomatically. This is appropria/te since the coipnment "Tiip cat is not a 
canine" is no longer needed.* 

ut is helpful to know that the method TUTOR uses for atJtomatically erasing 
such<text is by re-execu^Lljig tlte last -write-, -writec-, pr\-show- statement 
in the etirase mode. Supposed change the lesson slightly: 



wrong ^ cat 

write The cat is 

not a canine, 
irite Meow I 



4r : 



Now the sequence looks like this: 





The cat is 
not a canine. 



Only the last -write- statement is removed, leading "The cat is [npt a 
ccahift^* ^ screen. Notice that the normal automatic erasing caji be 
prevented sin^ly^ by^sid<J^ an extra -write- statement. Even a ^lank -write^. 
statement wil^ do. • 
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As another example Xconsider this: 



wrongv. 4 

write Number of apples= 
•^^how apnum 



Only the -show- will be erased, leaving "Number of apples=" on the screen. 
If this is not desirable*, use an embedded -show-: V 



wrongv 
write ' 



Number of apples= <i(s,apnum> 



Now the last -write- statement in^ude^s the showing of the nvimber, and all 
the writing will be erased. Itr-is important not to change "apnum" after 
the -write-. If you change its value from what it was wlien shown by the 
-Vrite-, the re-execution in mode erase will turn off th6 wrong dots in 
the numerical part of the writing. Here is the type of sequence to be 
avoided: 



wrongv 4 

write Number of apples= <ts,apnum)> 
calc apn\imO=apn\im+25 



The number will not be erased properly due to the change in "apnum". Similar 
problems can arise with the other -show-* commands, including -showa-. 

Sopietimes the* automatic, erasing of the last text statement is insufficient. 
For example, if the reply to the^ student included a drawing produced with 
^^-^aw-, or if there were seVeraf -write- statements, you ne6d some additional 
mectianism to remove the reply when the student presses ERASE. "There is an 





- V V 
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-eraseu- command which you cari use to specify a subroutine to be done wheii 
the student changes his response: 



eraseu eblock 
arrow 1215 



eblock 
1512 



unit 
at 

erase 35,4 

at 318 

erase 42 



Unit "eblock" will be done whenever the student changes his response. Only 
, the first press of the ERASE key triggers the erase unit, since additional 
executions of the unit would be erasing \nothing* , ' 

Another example involves an erase unit specif ic „to a particular response! 



3 dogs 
woof 
eraseu remove 



wrong 
do 



unit 
mode 
' . do 
^ mode 
eraseu 



remove 
erase 
woof 
wirite 



The sta^tement "eraseu rempve" defines unit "remove" as the unit to be dpne 
when the student presses ERASE (or NEXT, etc.). Unit "remove" in the example 
shown simply re-does unit "woof" in the erase mode, thus taking /of f the screen 
everything originally, displayed by unit "woof". . The final blank -eraseii- 
clears the pointer so there is no longer an erase unit specified. 

Notice the similarities between the -imain— and -eraseu- commands. Both 
specify units to be done under specific cpnditions. 



158 



VIII ^ 19 



/ 



Keeping things pn, the screen; "iftiiibit erase" 

Let us consider a modified version of the simple languages drill discussed 
in chapter. VII: . . ' ^ ' \, 



unit 
next 
back 
at 

write 



at 

write 
randu 
at 

writec 

arrow 

join 

unit 
ai|swer 

unit 

answer 

* 

unit 
answer 

unit 
answer 

unit 
answer 



Sspo - - 0 

espO 

♦satisfy 

512 , » 

Here is a' simple drill 

on the first five 

Esperanto numbers* 

Press BACK when you ' . . 

feel satisfied with your 

understanding. 

,1812 ^ * 
Give the Esperanto fqp 
item, 5 a 

2j315 . ' . 

item-2 , one , two , three , four , five ^^ 
2113 

item-2 , unu,du , prx , kvar , kvm 

unu 
unu 

du 
du 

tri 
kvar 

kvar c 

kvin 
kvin 



This version wi^ll greatly annoy the student after the first couple questions . 
The difficulty is that each time he gets an "ok" and presses NEXT to move 
on. to the next unit, the screen is erased and^he suffers through the intro- 
ductory paragraph being written again on the screen. It turns out to be very 
annoying to see text replotted this way because you already know what it says. 

This is a situation where most of the material <^.the screen is not 
changing and should not b^ replotted: \ only the item and the student ^s typing 
Qee^ be erased to make room for a new item and a new response-. One way to 
do this involves judging correct responses "wrong", as was done in the 
dialog using -concept- discussed in chapter VII. You should use 
"specs nookno" to prevent the "no" from appearing. Or you can use the - 
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regular -okword- and -noword- commands to change the stajidard TUTOR "ok" 
and "no". For example, use the statement "noword Fine!" to cause "Fine!" 
to appear for a correct response. You would need to do a "noword no" 
whenever the student answers incorrectly. 

we stay at the -arrow- ai)d do not move on to another main unit . 



With all responses judged ."wrong" 



Another way to ntan^ge a screen, on which little is changing involves 
.''inhibit erase", ^his statement prevents the normal full-screen erase 
upon leaving .-the present main unit. The^ext main unit^.must also execute 
an "inhibit erase" if no erase is to be performed upon leaving the second 
unit. We can rewrite our ^rill using this feature: 



\ 



unit 
at 

write 



at 

write 

goto 

* 

unit 
at 

erase 
at 

erase 
entry 



preespo 
512 

- Here is a, simple drill 
on the first five ' 
Esperanto numbers. 
Press BACK when you 
feel satisfied with your 
understanding . 
1812 

" Give the Esperanto for 
espol ' 



espo 
2J315 
5 

2115 
15 

espol 



inhibit erase 
next , 
back 
randu 
dt 

writec 
arrow 



$$ item, are^a . ^ . 

$$ response ajrea 

$$ leave instructions on screen 



join 



espo 
satisfy 
item, 5 , • 

2J2>15 

i tem-2, one, twp, three, four, five 
2113 

i tem- 2 , unu , du > tr i , Jcvar , kvin 



In unit "preespo" we display the instructions about the drill. We then go 
to "espol", where we inhibit erase and display the first item. Upon getting 
an "ok" the student moves on to the next m^in unit, "espo".^ The screen is 
not erased since there was an "inhibit erase". In unit "espo" we erase the 
area contfaining-'the displayed item, and we also erase the response area of 
the screen. We fall through the -entry- command "and display a new item. 
This process' repeats continually, and only those parts of the screen which 
must be changed are erased. ^ 
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It is important to place an "explicit blank -erase- statement ("erase *") 
at the beginning of unit "satisfy". Since we have inhibited the normal full-^ 
screen erase^ no erase will occur automatically when the student presses 
BACK to leave the drill. If unit "satisfy" does not explicitly erase the 
screen, the student will* see a supei^position of ''the drill display a^\d the 
display produced by unit "satisfy". 

: Similaily, if we specify a l^lp unit, that unit should staift 
with a >f ull-screen erase. Upon completion^ 0f the help sequence, we should 
come bacK^ to unit "preespo" rather than "espo" in order to restore the 
screen display properly. Do this: . ^ 



entry esj^1 

base pree^^o $$ to come back to preespo from help 



help esph^lp 



• ■ ■ \ • : 

The -base- command puts us in a^^lp sequence, with the base unit being 
"preespo". When a base unit has already been specified, pressing HELP 
doesn't change the base uijit (in other words, there •is only one "level" of 
help). When we reach an -end- commaild pr press BACK, we will return .to the 
base unit, which is preespo. Note that unit "satisfy" should have a blank 
base statement to insure that we are in a non-help sequence. Othe^rwise, 
pressing BACK in unit "satisfy" will bring us to the base unit *'preespo" 
again. , • 



Inj:eraction of "inhibit erase" with -restart- 

There is a -restart- command which is used to specify in which unit a . 
« student should resume study upon returning to a PLATO terminal. For example, 
suppose the last -restart- statement encountered on Monday by student 
"Ann North" in course "lingvo" was "restart espo" in lesson "espnum". On 
Wednesday she returns to a PLATO terminal and identifies herself by name 
(Ann North)^ and course (lingvo) . " Her registration records will show that 
she is to be restarted in unit "espo" of lesson "espnum" and she ^will 
automatically be taken to that; point. As discussed previously, the ieu 
(initial entry unit) » will be done*, which among other things permits character 
set loading. 

Unfortunately, rfestayting at unit "^spo" means that the basic drill 
instructions contained iii unit "preespo" will not appear (see last example)* 
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This is basically an initialization problem. You should use -restart-- 
commeinds in such a way aa\to restart students only at the beginning of a 
Miction of ^his kind. In this particular case, we should have had a 
•rel^art preesjx)" rather than "restart espo^*. This is analogous to our , 
\ise orV'base preespo" for returning from a help sequence. (The more 
common f^Mcm of the -restart- is the blank -restalrt-, which means "restart 
in the prSent main iinit". We would place a blank -restart- in ynifc "preespo".) 

t ■ , ^ • 

Aside ftoVinitializatipn questions related to TUTOR ^nd the display 
screen, it shbul^\be pointed out that the student ha« comparable initialization 
problems. Sinise tne^^^student may be ^ away for several days, it is usually • 
advisable to have youKrestart points only at tjie beginning of sections of 
the lesson. ' This way the. sttt^epC^can ease back intb the context, whereas 
restarting in the middle o3E^ discussion may be quite confusing. Jn lessons 
whose? structure includes an ihdex, the index ^ unit may be the ifest restart 
point. 

restarts in a lesson i lie starts at the unit specified 
by the 'l^tN^ start- command. Howevet; his saved variables, v1 through 
v150, have\wha1jever values were Current at the time he left the last PLATO 
claiss sessioi\. Therefore, some care is required to initialize appropriate 




variables in the restart unit. 



The -char- and -plot\ command^ 



Usually special ch^acteirs az^e hatidled with a -charset- command and 
displayed with a -write- statement using the FONT key. Alternatively, -char- 
commands can be used to transmit character^atterns to the terminal. If a 
-char- command sends a pattern to characlfeerslot 35 of the terminal, that 
character can be displayed using the -^^lot- commcind; "plot 35". The 
argtSments of the -char- command can be computed expressions so that a charactipr 
can be constructed algorithmically. Similarly, the -plot- command may have 
a mathematical expression for its tag in order to choose the Nth character. 
*See appendix A for sources of detailed information on the -char- command. 



The -dot- command 

The statement "dot 125,375" will plot a single dot at the specified 
location ("dot 1817" uses coarse grid) . A sequence of -dot- commands can 
produce sixty dots per second on the plasma display panel. A -draw- with one 
point ("draw 125,375" or "draw. 1817") makes a single dot by drawing a 
line from this point to this point and for technical reasons will produce 
only twenty dots per second. 
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Additional calculation topics \ 

; A ' ■ . '\ 

Before discussing addition^ TUTOR calculatiohal ca]!>abilitiesj let's review 
briefly those aspects which have been covered so far: 

1) Expressions ufollovT the rules of ^ high school; algebra^ Multiplication 
takes- pre<l9li^ce over division i which takes precedence over addition 
an4 subtra^^^||. Superscripts may be used to .raise numbers to powers. 
The symbol^ IT m^y, be used tt) mean 3.14159..... The degree ^X9^ (*^) 
may be used to convert between degrees -and radians . 

1 ^ y ' • ' " ' ' " 

^ 2) There a^e 15/J student variables, v1 through vtSjJ, yhich.fliay.be named 
with th^ 7def ine- comnjpid. These variables can be set or altered by 
assignment (<jsj) and by -store-, -s tor eh-, or -^storiBa-' ponmiands. If, 
a "define siudent" set* of definitions is provided, "i^e^^tudent may us6 
variable names in his responses. ^ 



3) Logical expression^ are composed using the operators =, >, <, ^) 
<, $and$, $or$, and the "not" function. Logical expressions have 
the value true (-|) or false (jj) • 



4) 



5) 



6) 



7) 



8) 



There are available -various system variables such as "where", 
"wherey",'^'anscnt", "jcount'', *'spell^*f ere. Av^able system 
functions include sin(x), sqrt(x) , etc. A full list, of system 
variables and functions is given in Appendix C. 



'The -show- comfaand ( an^ its relatives -showt-, -showz-, -showe-,j 
and -showo-) will display^ the numerical value of an expression. 
The -showa- command will display stored alphanumeric information. 
These commands may be embedded within -^write- and -writec- statei|lients * 

The -calcc- and -calcjs- commands make it easy tb perform conditionally 
one of a list^ of calculations or assignments. - 

The -randu- c<immand with one argument picks a fraction between 0 and 
1 ; with two arguments it picks an integer between 1 and the limit 
specified. There is a set of commands associated with permutations: 
-setperm-,^ "^raridp-, -remov^-, cuid -modperm-. 

The iterative form of the -do- command facilitates Repetitive oper- 
ations . - L • 



^Jow let us turn to additional TUTOR calculatlonal capabilities. 
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Defining your own functions ' ^. 

. Whide many important functions such as In (x) and log(x) are built^^in 
to the TUTOR language, it Is frequently .convenient to define your own functions. 
To take a simple example, suppose you define a cotangent function: 4 ^ 

define cotan(a)=cos(a)/sin(a) . * ^ 

Then later^ in your lesson you can write . s ^ ^ , 

c^^lc r ^cotan (3x+y-5) * - ■ 

and TUTOR will treat this as though you had written * 

* ' ' * \ ' <, ■ • ■ • „ 

calc r<J=[cos(3x+y-5)/sin(3x+y-5) 1 * ^ 

Such use of function!^ not only saves typing but improves^ readability. * . ^ 

CAUTION: In defining a function, the arguments giust not be already . 
defined." For example, the following definition will be rejected by TUTOR 
(with a suitable error message) : . : 

( 

. ■ ' ' ■ • • - ■ «• '. . ' • 

r define x=v1 ^ , , • . 

cube (x)=:c 

This must be rewritten as 



define x=v1 
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cube (dummy) atfdummy 

or anything similar. A function definition may involve previously defined 
quantities on €he right side of the "=" si^n, however : V" , « 



defixie i 



In 



x«v1 



new(c)=ac +2x- ' / 

caise you might have a -calc- that looks like^ 

calc x<l^lS^7 

y<^3neW(8) 

and this would be equivalent •to 

.* ■ ■ ■ -A 

calc x<i=15.7 ^ 

yO=3[(8) +2x] \- 

^"Sometimes it is ^ convefiiept to define "functions" that. 'have no argtamentsf 

define r==vT ^ 

. quad=r -100' 
r3=rV3 ; . • 

root=sqrt(r) 
- * ' .prod=r3xroot 

f> trans=(r<J=*prod) 
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Note that '"prod'* depend^' oh two previous definitions^ each of which in turn* 
depend on the def inition*^ o£ "r There is np Limit on how dqep you Ccfcn go in 
deffinition levels. The unusual* definition of'' "trans " perinits you to write 
an unusual -c^lc-^: 



calc- 



trans 




where the assignmeht is implicilt in the .definitipnT of ••trans". 

Essentially anything is a" leget^ definition. The only rule is that the 
definition make Sense when, enclosed in parenthese^i since a defined name 
when ^countered in an expression is replaced by its meaming and stCrfounded 
by pareiHhese^. Thi« means that yoja cannot define "minus**-" because (-) , 
a jninus' sign enclosifed in parentheses ^ is not! permitted in an expression. 
"minusT»-1" right .because (-1) is meaningful. ' 

A function may have up to -six arguments, x Here is* a function of two 
arguments: ' . * ' - 

* ' ' ■ ■ 

define modul>i^,bas6)=N^°[basexi.nt (N/base) ] 

Will mean that modulo" (17,5) ^j:^ an expression will,, have the value 2: the 
"int"' or "integral part" functi^^throws ^away the fract^onal-^part of 17/5, 
leaving 3, so that we have (17-5xJ|^a(i7-l5)=J?2. This modulo function therefore 
^yes you what is left over in divisi^ of ••*!" by ••base". 

!ere are a couple of other •^examples of multi-argument function definitions: 

def ijii^big (a,b)=- [ax (aib)+bx (b>aKI . 

ll(a,b)=-[ax(aib)+bx(b<:i^] . " " 

The miniils sign is there because logical true is represented by -1. If you, 
have "big(>{;+y,z)" in an expression, with (x+y)=7 and z=3, this expands 4o 

-I7>U7«)+3x(3>7)] ' ^ "^^^ >^ 

Which reduces to ^ t7x (-1 )+3x ()J) ] which is 7. So our ••big" function picks out*;, 
the larger of two arguments. CAUTION: The value of "big (2. 99999999999999,3)" 
is 6, ( I) instead of 3. The equality test in TUTOR, including the equality 
part of (^) or (>) , does a small amount of rounding to compensate for roundoff 
errors inherent to comjfSuters, so that "2.99999999999999^3" is true (-11. 
The tests (<) and (>) do not^do this, so "3>2\ 99999999999999" is^so true (-1). 
Therefore, a better definition to pick pUt the larger of two numbers is 
"define big (a,b)=a- (b>a) (b-a)-". Similarly, write "femall(a,b)«a-(b<a) (b-a)". 
*• > ' - 

•Arraj^s , - ' , ' ' ' . ' 

It is often important to be aj)le to deal with arrays o^ data such as,, 
a list of exam scores, the number of Americans in each 5-year age ^group to-, 
gether with their corresponding mortality, and fertility rates,' a list of which 
pieces are where oi\ a chess board, or .the present positions' of each of gever^l 
molecules in the sJCmulation of the motion of a gas. 
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"Suppose we have somehow entered the exam scores for twenty students 
into variables v31 , v32,. vSa,"^. . . . up to v5^. Here is a unit which will^ 
let you see the scoire of the 5tjh or 13th or Nth /student: • 

unit * seQ.\ 

back inde^ 

at 1215 

writer Which s'tudent number? 

^ (Press PS^CK when done«) 

arrow 1518 

store N 

wrongv i;j.5,9.5 range 1 to 2f5 

write The score of i^e '<(s,N> th student is <s,v(30+N)>. 

(The -wrongv- rather than -ans\^ make? it easy to ask another question.) The 
new element Here is the "indexed^iciable" 




v(30+N) 



\ 



which means "evaluate 30+N, round to -the nearest integer, and\choose the 

corresponding variable". For example,,, if N i^, v(3iJ+N) is v^9) or v39. 
If N is 13.7, v(3;J+jl) means v44. V 

We might list and total all the scores: 



ft 

calc total<F»0 $$ initialization step 

do showem,N<}al ,20 

at 3035 - ^ V 

write The 'average score is <[s,total/20)> . 
. * ' 

showem ' ^ * 

835+10iJN ' ' \ 

v(30+N) 

totalxjatotal+v (3^1+N) 



unit 
at 

show 
calc 



' as Usual it is far preferable tovdefine a name for "these data: 

* \ 

s ; ' ' ^ 

n define scores (i)=v(30+i). 

in which' case we would write our lastf unit as 

.unit showem 

at 835+10j3N 

show * scores (N) ^ 

calc total<=total+scores (N) : 




Due to the special meaning attached to *"v (expression) " you must exercise 
some care in using a variable named "v", in^ that you must write "vx(a+3b)" 
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and not "v(a+3^)" if you mean multiplication. We will see later that the 
same restriction applies to the names "n'S "vc", and "nc". This restriction 
doeSNiot apply to students ent^ering algebraic responses, where "v(a+3b)" 
is taken to mean "vx(a+3b)". Students can use indexed variables only if they 
are named, as is "scores'" in the above example; such -definitions must, of 
coiirse, be ifi the "define student" set. ^ ^ 

Suppose you have three sets of exam scores for the twenty students. 
This might conveniently be thought of as a 3 by 20 ("twq-dimensional") array. 
Suppose we put the first twenty scores in v31 tWfough vSj?, the second set in 
v51 through vTjJ, and the third set in v71 through v9iJ. It might be convenient 
to redefine your array in the following manner: 

define scores (a, b)>v(10'i-20a-«-b) 

» 

Then if you want the 2nd test score for the 13t:h student you just refer to 
scores(2,13) which is equivalent to v(1i2H-4iJ+13) or v(63). If you wanted 
to display all the scores you might use "nested" -do- statements: 



do 
* 


column, iO^I ,3 


Unit 


column 


do 
* 


;rows, j ^1 ,20 


unit 


rows ' 


at 


820+1^!i+100j 


show 


scores (i, j) 



\ Unit "cofumn'V ^Q"® three times, and fgr each of ti^ese iterations unit "rows 
"^is pCTlIfirilled Twenty times,. ^ ^ 



There -is an alternative way to def 




our array: 



define i«v1,j=v? 

scores-v ( 1 0+20i+ j ) 

Then our unit "rows" would look like 

unit rows 
at 820+10i-f100j 
show scores 

The indices specifying which test for which student are implicit. 'This 
form is particularly useful when you have large subroutines where "i" and 
"j" are fixed and it would be tiresome to Jiype over and over again 
"scores (i,j)". Just set "i" and "j'S then -do- the subroutine. 



It is frequently niacessary to initialize cin entire array to zero J One 
way to do this is with -do- statements: 



unit clear 
do clear2|i4*1|3 
'* . . * 

unit clear 2 

clear3, ,2jJ 

unit clear3 
calc scores (i|j)0»i3 

A simpler way tQ^>accomplish the s^on^i^ask is to say 

zero scores ( 1 1 1 ) 1 6)3 

You simply give the starting location (the first of the 60 variables) and 
the number of varied^les to be cleared to zero. As another example » you 
can clear all of your yarieJDles by saying 

zero v1 1 150 s. 

Not only is the -zero- command simpler to usei but TUTOR can carry but the 
operation^ several hundred times faster 1 TUTOR keeps a ^bloqk of its own » 
vari^iblesi each af which always , contains zero* When you ask for 150 varial^Les 
to be cleued I TUTOR does a rapid block transfer of 150 of its zeroed vari- 
edsles into your specified area. This ultra-high-speed block transfer ^ 
capability can be used in other ways: 

transfr v10;v85;,25 

performs a block transfer of the 25 vauriiables starting with v10 to the 25 
yeuriables starting with v85. In this way you cem move an entire array from 
one place to another with one -tremsfr-. command i and at speeds hundreds of 
times faster than are possible by other meems. \ ^ 

Segmented variaBle^ ^ 

- ^"Storing three scores for each of your twenty students reg[uired the use 
of 60 variables I but of 150 availed^le. We* re running out of roonl You can 
save space by defining "segmented** variables which make it easy to keep 
several numbers in each student varizd^le. For example ^ yoja cem write a 
definition of the form 

! • ■ 

define segihent , score»v3 1,7* 

This identifies "score" as an array which starts at v31 and consists of seg- 
ments holding positive integers (whole numbers) smaller than St^^ (which is 
128). It^turns out that each student varieO^le will hold 8 such segments. 
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SO "score (8)" is the last segment in v31, while "score ia the first ^ 
segment in v32. Since "score (6j3)" is the fourth segment in v38V we need 
t only eight* variables to hold all sixty scores! You can use "score (expr) " 

in calcul2^tion8: the expression "expr"' will be rounded to the nearest 
integer and t hie appropriate segment referenced. As a simple example ^ 

\ calc score(23) Oi8core (3)+5' 

will get the'^third segment, add 5 to it, and store the result in the twenty- 
third segment. 

If we define a segmented ohe-dlmensional ^rray "score"^ we can define 
a two-dimensional array as before: 

: ■ , • , * ^ '.. 

> . . .define segment, scorc«v31 ,7 

^ scores (a, b}«score(2jlfo*-2j9-i-b) 

with these definitions, "scores(1,1)" means "score (20-20+1 or "score^U", 
which is the first segment in v31 . As before, "scores" could use implicit 
indices: * \ 

define i«v1,j«v2 ^ ' 

scored-score (2j3i-2j3+j) 

in which case you use "scores", rather than "scores (expr 1 ,oxpr2) in cal- 
culations. NOTE: At the present writing the commands -zero- and -transfr- 
cannof be used with segmented variables because these commands refer to 
entire varieU>les. You could, however, zero all of the scores by saying ^ 
"zero v31,8" which sets v31 through v38 to zero, which has the effect of 
zeroing all the segments contained iri those eight variables; You can make 
such manipulations more readable by defining your segmented array this way: 
, ■ i) ' , 

define start«v31 , . 

segment ,^core=start, 7 

• Then you caiT^te "zero start, 8" rather than "zero v31,8"i Similar remarks 
appli^r to the -transfr- command. 

It is possible to store integers (whole nuinbers) that can be negative as 
well as positive: 

define segment ,temp=V5, 7, signed 

The addition of the ward "signed'' (or the abbreviation 's") permits you to 
hold in "temp(i)" any integer from -63 to +63. The range 2^ (128) has been 
cut essentially in half to accomodate negative as well us positive values. 
The following table summarizes the unsigned an^ signed ranges of integers 
permissible for various segment size specifications up to 3jS (sizes up to 
^ 59 are allowed,, though beyound 3 J3 there is only one segment per variable). 



J 
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signed range 


No. of 


sxzo 








segments 


n 


2" 








per 








variable 


V' — 




JO to i 






60 


2 


H 


(A *-r^ ^ 

jO ZO J 


-.1 £o +1 


30 


3 


Q 

O 


• jiO ZO 1 


-3 to +3 


20 


4 


1 D 


W TO ID 


-7 to +7, 


1 5 






Joy uo J 1 / 


-15 to J 


his . 


1 2 


6 


64 




•-31 to! 


1-31 


Iff 


7 


1 


)p to 1 4& / 


^DJ uQ tOJ 




8 




TP uO 233 - 


" 1 ^ / to T 1 ^ / 1 


7 


9 


CIO 

51 2 


JiJ to 311 • 


"^3^ to tZ33 


o 




1'H024 


J5 to 1 J023 


^ "3 1 1 to t3 I 1 




1 1 


2 048 


j9 to 2 04 / 


\ -1 023 to +1 023 




12 


4 096 


Jo to 4 J395 


-2 047 to +2 047 ^ . 


3 


13 


8 192 


0 to 8 1 91 


-4 tf95 to +4 095 


A 


14 


16 384 


JJ to 16/383 


-8 191 to +8 191 




15 


32 768 


fS to m2 iol. 


-16 383 to +16 383 


A 


16 


65 536 


jo to 03 333 


-32 767 to +32.767 


•a 


17' 


131 J872 


0 to 1 3 1 07 1 


-65 535 to +65 535 


3 o 


18 


J, 262 144 


0 to 262 143 


-131 071 to +131 071 


3 


19 


524 288 


j9 to 324 2o/ 


-262 143 to +262 143 


3 


» ft 

. 


4 ft A n c ^ 

1 J348 576 


0 to 1 J94o 3/3 


-524 287 to +524' 287 


3 


91 




0 tD 2 fi!(97 151 


-1 048 575 to +1 048 575 


"2 


22 


4 194 304 


0 to 4 1 94 303 


-2 097 151 to +2 097 151 


2 


23 


8 388 608 


0«to 8 388 607 


* -4 194 303 ^to +4 194 303 


2 


24 


16 777 216 


0 to 16 777 215 


-8 388 607 to +8 388 607 


2 


25 


33 554 432 


0 to 33 554 431 


-16 777 215 to +16 777 215 


2 


26 


67 108 864 


0 to 67 108 863 


-33 554 431 to +33 554 431 - 


2 


27 


134 217 728 


0 to 134 217 727 


-67 108 863 to +67 108 863 


.2 


28 


268 435 456 


0 to 268 435 455 


-134 217 727 to +134 217 727 


'2" 


' 29 


536 870 912 


0 to 536 870 911 


-268 435 455 to +268 435 455 


2 


30 


1 073 741 824 


0 to 1 073 741 823 


-536 870 911 to +536 870 §11 


2 



As an example of the use of this table , suppose you are dealing with integers 
ifi the range from -1200 to +18J^. You would need a segment siz^e of 12 (signed), 
which gives a range from -2047 to +2047. There would be 5 segments in 
each variable. Your -define- might look like * ' 



define segment,dates=v1 40, 12, signed 

You need not understand the rationale b'e^ind this table in order to be able 
to use segments effectively. An^ explanation of the underlying "binary" or 
"base 2" number system and the associated concept of a "bit" are discussed 
/ later in an optional sectioh of this chapter. 
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A 'common use of segments is as "flags" or markers in a lesson. For 
example, you might like to keep track of which topics the student has Com- 
pleted or which questions in a drill have obeen attempted* A segment size 
of just one is sufficient for such things, with the segment first initialized 
to zero, then set to one Vhen the topic or question has peen covered. The 
definitipn- might look like this: f 

define f lags»v2 ,^ 
segment , flag«if l^gs, 1 

Start by executing "zero fla^s" to' clear all sixt>y^egments in v2. (If you 
use up to 120 markers you would use "zero flags, 2" to clear two variables, 
each dontaining 60 segments.) When the student completes the fourth topic . 
you say "calc flag(4)<J»1" to set the fourth flag. You can retrieve this 
information at any. time to display to the student , which topics he hag com- 
pleted". ^ ♦ 

Although only whole niimbers can be kept in segments, it is possible to 
use the space-saving feature^ of segments even when dealing with fractional 
numbers. Suppose you have prices of items which in dollars and cents involve 
fractions, such as $37.65 (37 dollars plus 65 hundredths of a dollar). Assmae 
that $50 is the highest price for an item. Simply express the prices in 
cents, with the top price then being 5^(00 cents. From the table we see thatt - , 
a se^ent size of 13 will hold positive integers up to 8191, so we say V ^ 



4»S±ixe price=vl $$ in dollars and cents 

segment, cfents==v2, 13 * 
put(i)=cents(i) <>3ljJiJprice 
get ( i > =pr ice <3=cents ( i) / 1 jjjj 

A sequence using these definitions might look like 

qalc price 4s28. 37 

calc put(16) $$ equivalent to "cents (16) <s1/Zf0price" 



\ 



show ^ get (16) ^ $$equivalent to "price«=cents(16)/1iJ/!l" 



The final -show- ^ill put "28.37" on the screen, even though between the 
"put" and "get" the number was the integer "2837". • Notice the unusual 
''calc put (16)" which has an assign«eftt^<}=) implicit in the definition of 
"put".. Also notice that the variable "j^ice" is affected as a side-effect of 
referring to "get". If this is>ot desire^ we C9uld define 
"get(i)=cents(i)/1j00". 
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As^^fnother example of the use of segments with fractional numbers, 
\ ' suppose, you have. automobile trip mileages Up to, 1^00 miles which you want 
* * to store to the nearest tenth-mile (such as 243*8 miles>. In this case 

you must multiply by 10 when storing into a segment and divide by 10 when 
retrieving the information.' You would use a segment size of 14, since your 
biggest number is 10000. at\ should bq pointed out that rounding to the 
nearest integer occurs wh^n storing a non-integer value into a segment: 

calc miles <r=539. 47 * ' 

seg(2)^10 miles $$ 5394.7 becomes 5395 . 
miles<?=seg(2)/10 $$5395/10 or 539.5 

■ So by going into and out of the*segment, the "539'^47" has turned into "539.5'% 

Aside from the restriction to integers, calculations with segmented 
Variables have one further disadvantage i» they are much * slower than'calcu- ^ 
lations with 'Whole variables. ' This i^ due to the extra manipulations the 
. computer must perform to compute ivhich variable contains the Nth segment^, 

and extrarct or insert the appropriate segment. Segments save space at the ^ 
expense of time. In .many cases this 'does not matter, but yoa should avoid 
. doing a lot of segment calculations in a heavily-computdtional repetitive 
loop, such as an iterative -do- done ten thousand times I 



• /// ' . ' Branching wit hin a unit: -branch- and -doto- 



.V,- 
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All of the branching or sequencing commands discussed so far deferred 
to -unit-s (or -entry-s) . It i^ often coi;ivenient to be able to branch 
within- a unit, which is possible with the -branch- ^mmand: 



unit somethin 

> branch count-4,5,x,8c^f ter 

at 12^5 

write "count" is equal to 4 
5 

do countit 

Bafter count <f=15 



The tag of the -branch- command is like the tag of a -goto-, except that unit 
names are replaced by "statement labels". These labels appear at the begin- 
ning of statements and must start with a n\imber (0 through 9) to distinguish 
them from, commands, which start with letters. A statement beginning with a 
label need not have any tag (as ip the line above labeled "5"), but it can 
have a tag like that of a -calc-, as in the last statement above 
("Safter count4=15"). In fact, a labeled statement is essentially a -calc- 
statement. ; , - 



Vou can now define another kind of segmented variable 
("define segmert^, vertical, ") which is handled much faster, 
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As With -rgoto-, "x" ih a -branch- means "fall through" to th9 next ateitor 
ment^- The "q" option in a -branch- means "cjuit doing a -cejtlc-^* eind proceecl? :^ 
to the next non-calc statement. Here is an example: . ' ♦ ^ . // 



branch- t>15,q,x ' / ' • * : ' ' ■ 

calc • a4^b . ' ' , .'^'^ 

bO=b+t /V"^' ^■'^■■''^,V..:V-.^^;'' 

Bend t<$=t^ \ / V • , . 

... a^a+t . ^ " -r'-- ■ ' 'V' 

calc b<?»b3 /V' 'V- . ' ' - 

write Anything - , V ' ^f - * /' * ' '^ ' ^ . 

If t Is greater than 15, . we have a "branoh q" /all t^e ^^ay t6';t^t 

which is the first non-calc statement following ^ibtJ&x\!^ ^ 



The -branch- command is itself a nont-^calc comrtiarid; . , ^ 

'* -branch a^q^^x " • ■ . ■ 

.'calc a^sb ^ >' ' * • ■. ■ v' " ■ '/''^v ' 

branch c=d,8i,8j,8k ^ / / • ^ /; 

If "a" rounds to a negative integer, the "q" toa^c^h'^ is 'taken ^t^ t^he next/ 
-branch- command, • bypassing the -calc-, ^ '// ; * 

^ ■ ' ' // ' • 
There is an alternative version of -branch-^; i^ a -^c^M- as £/at as 

a preceding "branch q" is concerned. word "bt^ricflh" is placed in the 

tag ; ' ■ ■ . ' ■/■."'/ .' '/.■ ^ //•-, 

branch a,q,x ^;/.'..7 .:j ,A' '/ //, " 

. calc a<^b ' / '//-m ■./'v ' ' '■V'^''' ■■ j'^^'^^'^V' ; 

branch a^c,x,9sltip " ' i'/'/ 7'^'-'/',' ' i ' V / ' ^ ^/^Z ' ' 

* . ^<^^^ ?/;-:'//^^//^ ■/^■' ' '^'-'^'"^ '777;'//' - 

write • some more ' / ^7 ■.//■ '' ■ ■ '/ / , ../.'-V.',';" ■, / • 



The "bfanch q" takes us to the -wfite-, ^^/hce the only tfhi^g;^!^ 
first -branch- and the -write- are lineW iJtairtijrt^^;^^^^^ ' 
("continued -calc-"), or statemefirT^bo^fiMw^ 



\ 



So -branch- can 'be either -calc- type Or riorv^ 

typographical advantages, permitting a icind of in^eii^^^^^^ a 
complicated sequence of -cAlc- statemferits mori^ *^^d^w4l ^ th^in the effect 

on a preceding "branch q", there is no dlffefehop ^s'tw^'sn /th^i ?i:wO kinds of 
-branch-.. , ' ^^^'•■/'■ 4 r / 

It IS not pemissible in a unit to label twof stk^eman^^ the same 

label (nor can you have two units with the saitte i^^e'i^^^ On the 

other hand,, since -brangh- operates only within :a^i^^ oanaOt refer to 

labels ih other units, it is all right to use, the sa^^^ 

iinits. (Similarly, you can use the same unit jrimei/ jfi different lessons.) 
Note that -entry- is similar to -unit-, so -branch v cannot be used to branch^ . 
to a label if an -entry- command intervenes* : » ' 



V 



It itf often convenient to use -branch- rather than -goto-. In addition; 
-branch- requires less computer processing than -goto-, so that heavily 
computational iterations are better done with -branch- where possible. 

Just as -branch- is a fast -goto- within a unit, there ig a fast -doto- 
analogous to -do- for use within a unit : 



Hoto 
calc 
at 

write 

Send 

circle 



o€end , i ^f irst , last , incr 
a<-bxsin(5i°) 
1jJjJ,2jJjJ+2a-i 
T 



The tag of the -doto- is similat to an iterative -do-, but instead of naming 
a unit to be doae repetitively you name a statement label. For each iteration 
TUTOR executes statements from the -dotp- down to the named statement labll . ' 
After the last iteration is performed, TUTOR prodee^s to the statementj^ichi 
follows the -doto- label (^circle- in the above example). 

Just as it is possible to have nested -do- iteratior^, nested -doto-s 
can be set up. Here is a comparison of -do- and -doto- for displaying a 
two-dimensional array: 



-op- 

coltHiiuiii 0=1 ,3 
columhx^ 
rows, j 0^2^f 
rows \ 
^2JJ+1JJi+1j3jJj 
scores (i,j) 



-doto- 



do 

unit 

do 

unit - 
at 

show 



This nested -doto- example has thg^tructure 



doto 




doto 
doto 
at 

show 

.4 ' 



4;i<5s:1 ,3 

^4,j^1,2^J 
82^4-1JJi+1iJiJj 
scores (i,j). 



dotO" 



4 -1 



4. 



ERIC 
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Other possiblre structure include theses 



doto 
doto 
5 
8 



doto V 



doto 
doto 
3 
5 




doto 
doto 
3 

doto 

5 
8 



~ilote that in each case the "inner" -dotorS\ are nested within the '^uter" 
^ •*doto-s. Here -is a counter-example which \s not permissiblet " ^ 



ILLEGAL 1 



doto 5 —y 
doto 8- 
5 

< 

8 

■ ■ \ ' _ . • ■ ■ ^ 

TUTOR does not permit this kind of structure. - 

As with -branclyr, it is posfsilple to put -doto- in the tag , in which 
case it is skipped ov6r bj^ a prec6liing "branch q". Again , the purpose ' of 
this kind of indenting is^ to make some kinds of long continued -calc- state- 
ments more readable. \ ' 

• ■ ' ■ \ .• • ■ V. .. • 



Integer variables and bit man^ipulf^tion 



This section goes much more deeply into the way a computer r.epresents 
numbers and chciracter strings. Skim this section on the first tiine through 
to see whether you will need to study it in detain^ YoU should need this 
material only if you pack several pieces of data in^ne^variable-or if you 
war\t to use -calc*- operations on chlaracter strings. 

A variable such as v^5ji can hold a number, as big as 10"*'^'^ (the number 
1 followed by 322 zerpsl) or a'non^-ziero number as small as 1J2(""293 (a 1 
in the 293rd position after the decinial . point! ) • These huge or tiny niimbers 
may be positive or negative, from ±i^"293 ^p ±ljj322^ number held in 

V15/J is recorded as sixty tiny "bits'* of ij^Eormation. For example, whether 
the number *is positive or negative is one mt of information, and whether the 
magnitude .or IJZP^^^ is another bit of information. The remaining 

^58 bits of information are used to specify precisely the number held in v^5^!* 



1 7 



^ . IX - 1 4 

What is a bit? * A bit is the smallest possible piece of ^Ixif omation 
and represents a two-way (binary) choice: yes or no (or triie or false, or 
up orxdown; anything with t^o possibilities) . A number is positive or nega- 
tive and these two possibilities can be represented by one bit bf 4^^formation, 
Numbers themselves can represented by bits correspondihg to yes or" bo. Let 
us see how any number from zero to seven can be represented by three bits 
) corresponding to the yes or no answers to just three questions, SupjDOse a 
• frierid'is thinking of a numb^ between zero and seven and you are to detemine^ 
it by asking. the fewest possible questions to be answered yes or no. Suppose 
the friend's numbeli: is 6: 

a) Is it as big as 4? * yes, 

b) IS it as big as 4+2? Yes. 

c) Is it as big as 4+2+1? No. 

From this you correctly conclude that his number is 6. YoV determined that 
his number was made up of a 4> a 2, and no 1. You might also say that his 
number can be represented by th^sequenc^e "yes, yes, no"! 




As another example try to guess a number between zero and 63 chosen by 
the friend. Suppose it is 37: 



a) 


Is 


it 


as 


big 


as 


32? 


Yes. 


b) 


Is 


it 


as 


big 


as 


32+16? 


No. 


c) 


Is 


it 


as 


big 


as 


32*8? 


No. 


c) 


Is 


it 


as 


big 


as' 


32+4? 


Yes.' . 


d) 


Is 


it 


as 


big 


as 


32+4+2? 


No. ^ 


e) 


Is 


it 




big 


as 


'32+4+1? 


yes. 



So the number is 37, or perhaps "yes, no, no, yes, no, yes"! Try this questioning 
strategy pn^ any number from zero to 63 "and you will find that six questions 
are always sufficient to determine the number. The g^trategy depends on cutting 
the unknown range in two each time (a so-^called "binary chop"). 

. ' ■ y 

Conversely, any number between zero and 63 can be represented by a 
sequence of yes and no answers to six such questions. What nximber is rej^re- 
sented*by the sequence ^ ^ ^ . \\ 

yes, yes, no, yes, no /yes? ^ 
1^ , - - . • . . * 

This number must be built up of. a 32, a 16, no 8, a.4> no 2, and a. 1 • 
32+16+4+1 is '53i so the sequence r^resents the number 53. 

Because a yes or no answer is the smallest bit of information we cani 
extract from our friend, we say aiiy number between zero (six nos) and 63 
(six yeses) can be represented by six bits. If on the other hand we know 
the number is between ^zero and seven, three bits are suffidient to describe 
the number fully* Similarly, numbers up to 15 (2^-1) can be expressed with 
fbur bits, and numbers up to 31 (2^-1) with five bits. *3ach new power of two 
requires another bit because it requires another yes/no question to be asked* 

■ '■ ^- . ' ' ' ^ ■ ^ • 

3. . . ' ■ . 




173 



Thi^ method of representing nvunbers- ak a sequence of bits j each bit 
corresponding to a yes or riO| ''is called "binaty notation" and is the method 
normally used by computers. tfiThether a computer bit represents ye^ or no is 
typically specified by a tiny electronic switch being on or o§f, or by a tiny 
piece of iron bfeing magnetized up or down. A TUTOR variable. contains sixty 
bits of yes/no information and could therefore be used to hold a positive 
integer as big as (2^^-^1), ^^^ch is approximately 1J3^^, or 1 followed by 18 
^eros! What do we do about > negative integers? Instead of using all sixty ^ 
bits we pQuld give up one bit to represent whether the number is f5ositive 
or negative (againi a two-way or binary bit of information) and just use ^ 
59 bit^ f or the magnitude of the number. In this ^y we. could, represent 
positive or negative integers up to 

±(259 

-1), which is approximately plus or 
minus one-half of 10}^*. ^ . ' 

But what do we do about .bigger numbers j 6r numbers such as 3.782 which * 
are not integer^? The scheme used j^s ^^dl<^9ous to the scientific nprtation • 
Used to express large nvmiber^: 6./32X1J323 ig a much more compact form than 
6J32 followed by 21 zeros^ *and it consists of two el&j^ent;Lal piecesT*the humbelr 
6^)32 and the exponent or power of, ten (23). Jnstead' of iising 59 bitg for the 
nvmiber, we use only 48 bits and use 11 bits. for the exponent. Of these 11 
bits i one is used to say whether the exponent is positive oryaegative '(Uie 
difference between l/zr*"^, a million, and AfT^, One-milliontl)) . The remaining 
tenj^tits are used to represent exponents a^ big as one thousand (^1^-1 is 
,1)323, to be precise). ThQ exjaonent is actually a power of two rather than > 
ten^'as though our scientific notation for the pvunber 40 were written as 
5x2^, instead of 4xij3l . That is, instead of lexpressing the nximber forty as 
4x10lj we express it as 5x2^, putting the 5 in our 48-bit nvimber and the 3 
in the 11-bit exponent s€orage place. In this'waj^ we split up the 6/J bits as 

1 bit; for positive 'or negative number / 
«1 bit for positive pr negative exponent 
1/J bits for the power of two • 
48 bits for -the number n * 

Tl^e 48-bit nxamber will hold an integer as big as (ij^9-1 ) , which is about 
2.5xl)Zf^'4, If we wish to repriBsent the number 1y<4, the variable will have 
a number of and an exponent of -49 i . 

2^'^x2-49=: 2''2=: 1/4 ^ ' 

That is, the 48-bit nximber will hold a large integer, 2^^, and the exponent, 
or power'' of 2, will be -49. The complicated fgrmat just described "Is that ^ 
used by the ^L^TO computer when we calculate with variables v1 thrbugh v15iJ. 
It automatically takes care of an enormous range of nuiohers }ji^~s^aratiikg 
each niomber into a 48-"bit number and a power ^f two. This format is called 
"fractional" or "floating-point" format because non-integraP values can be 
expressed and the position of the decimal point floats automatically right or 
left as operations are performed on the •variable. 
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Sometimes this format is» not suitable, particularly when dealing with 
strinfifs^of characters. The -storea^^ command and -pack- commands . place ten 
alphanumeric characters into each variable or 'Iword" -(a* computer variable is 
often oalled a.. "word" because it can contain several characters). We simply 
split up the sixty bits of the word into^ten characters of , si« bits ^^ch, 
six bits being suf f icifent. to specify one of €4 possible cha^acteirsj from 
character number zero to character number 63 (2^-».1), In this scheme character 
number 1 corresponds to an "a"i number 2 to a "b", number -26 to a "z", number 
27* to a "jJ", number 28 to a "1", etc. A capital D requires two 6'-bit 
character slots: one for a "shift" character (which happens to be number 56) 
and one for a .lowe;r-case "d" (niunber 4) • ' The -showa- command takes such 
-striAgs of 6-bit character codes and dismays the corresponding lettersj 
numbers, or punctuation marks on the student's screen. 



Ridiculous ^things happen ^f a -showa- command is used to displaiy a wordl^^^ 
■wfaichJcQintiMJ^g^ lo^^ niimb^er . The , two sign .bits {for the nrniber^^^^^^^.^^ 

and for the exponent) and the first fpur bits of the the exponent make up the 
first 6-bit characteSr code! The last Six bits of the exponent' aro taken as 
"specifying the ^second 6-^bit code. Theh the remaining 48 bits aire taken as 
specifying eight 6-.bit character codesV Small wonder that using a -jshowa- on 
anything other tha» character strings usually puts gibberish on the -scr^n. • 
On the other hand,us.ing. a -show- with character string gives nonsense: the. 
floating-point e^a^i^^i^t^^ets irtade up out of pieces of the firs't and second 
6-l)it character codes, tiie 48-bit number comes from the last eight character 
co^s, and whe'thef the number , and* the exponent 'are positive or negative is 
deterroined by the first two bits of the first character code! ^ . p 



sign af 




umber 



of exponent 



floating-point 



48 -bit number 



1 1 ■ 


10 








48 bits ; 






■\- ■ 


















haracter string 




t 


h 






c 


.1. 

o 






J' 


« 

" u. 




6 


6 


6 


6 


6 


' 6 


6 


6 


^ ' " 6 bits 
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•So far we have kept numerical manipulations (-calc~, -store-, -show-) ' 
compiei^ely separate from character s*tring mariipulations (^storea--, -showa-) . 
The reasons should now be clear. It is nevertheless sometimes advantageous 
to b*e abl4 to use the power of -calc- in manipulating character • |trirtgs and \, 
similar sequences of bits. For such manipulations we would- like to notify 
TUTOR not €o pack numbers into a/variable in the use'ful but Complicated floatirj^- 
point fdrmat. ♦This is done by /rie f sirring/ to "integer variables" 



n1 ,n2,n3 



-n1,49,n^5Jf 



'The integer variable n17 is the same storage place as v17/'but its inter^ial 
format will be. different. If we say /"cdlc v17<$=,6", TUTOR will put into ' 
variable number 17% the number 6, expressed as 6x2^^ with an exponent of -45, 
so that the complete^ number is 6x2^5x2-45^ 5^ ^y^^ oth^r hand we' 

say "calc n17<>=6", TUTOR will just put the numbef 6 into variajale number ^1^>^ 
Since* the number 6 requires only three bits to specify it, variable 17 will'f" 
have its first 57 bits 'unused, unlike th.e situation when we ref^r to the : 
17th vajf-iable as v17, in which ^case .both the exponent and the magnitude' pdirtions 
of the variable contain in^rmation. - " . 

evponerit , ' ' nufnber . ... 



•4? 



vl 7<J=6 




Cpnsifder bhe following sequence: 



calc 



A' 



nl7<}='6 



, . : at,^ 1223 . • 

Q showa n17,1^> , • • 

This Vill^<:au9e^an f'f" (the 6th letter 4n* the alphabX> to appear on the 
screen at Ibca^tion 1223. The first! 9'c?haracter codes in n17 are zero, and 
these ^gero or "nunh codes have no -effect on t?he screen or screen positioning. 
Ind^ecJ, a "shpwa ^17,9" y^oMlil disblaly nothing since the "6" is in> the tenth 
cj;iaractfer slot. If we use "sfiow' *|ii17"'; . we'yill just see a ^'6" on the screen. 
The integer -format <if n17 alerts fsixo^ not^ to/exp^t ^a^ floating-point format. 

If you say' "calc ^'|n23<^5'.7"., vara^^le n23 will be assigned the value 6: 
roxinding is p^ar formed in assigning value is to Integer variables. If ^truhcatipn 
is 'degared, ujS6 .the "ipt"\ function: '"n23.<J=int(5.7) " will assign the integer ' • 
palrt? (5) to n23*. indexed integer vari^les are written* as "n (index) " in'' 
analogy with "v (index) ".. — . , 
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The -showa- and -storea- commands may be used with either v^variables 
or n-variables. These commands simply interpret any .v- or n-vari£UdXe as a 
character string. This is the reason why we were able to use -showa-^ and ^ 
-stor4^- without discussing integer variables* , ' * 

, , It As possible to shift the'^dts aroun^l!|side an integer varizd>le^ In 
particular I a "^circular left 8hift^> aJdbreviated as $cl8$i will Piove bits to 
the left I with a wra^raround to the right e^id of the veuriable: 



calc 



n17<S=6 $cls$ 54v 



at 

showa 



1223 
nl7,1 



$$show ^e character 



will display an"**f" even though the -showa- will display only the first 
charac^er> because the "6" has been shifted left 54 bit positions (d six- 
bit character position^) . ^ A circular left shift of 54 mAy also be thought of 
as a right circular shift of 6 because of the wrap-around nature of the 
circular shift. ^ « 
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We have been using T'n 17" ^as cin exai!;iple> but of course we should be 
writing "inum" or some i^ch nain^> where we have used a -define- to i 
specify that "inum=n17". ^ For the remainder of this chapter we revert, 
therefore, to the custom of referring to variables (v oif n) by name |:ather 
than number. Also, if we want the character code corresponding to the letter 



"f" we should use "f" rather than 6: 
calc inum<5=:"f" $cls$ 54 
is equivalent to but much more readable than 

^ calc n17<J»6 $fels$ 54. \ 

• ' ' ' \ ■ 

The quotation' marks c^n be used to specify strings \of characters « 

calc inum<J="cat" 

|Will put tl^ese number | in inum: ^ 

' ( » - ■ 

; null nu. 1 1 1 1 . nu 1 1 m 1 1 ^^fMlT^ t^u 1[|1 



\ 



For, excunple. 



\ 



0 



0 s 



0 



0 



,0 



0 



1 



20 



A "showa inum,1JJ"\(lll display "cat". Nc3l:ico particularly th^t using 
quotes in a -calc- to x^f ine a character string puts the string at the 
J^ight ("right adjusted" )> whereas the *-storea*- and -pack- coanands produce 
left -adjusted character strings. It is possible to create left-adjusted 
character .strings by using single ^ quote marks: inura^'cat' will place the 
"cat" in the fjjt^st threi^ character positions rather 'than the last three. 

Let us now return toXour early example of the number 37 expressed as 
the sequence of six bits "Ws,no,no, yes, no, yes". If we let 1 stand *for 
"yes", S^d fl for v^no"j(s^we might write this sequence as * 



which stands for 



(Ix32) + (0xl6) + (j3xa) + nx4) + (^jx2) + (lxl) 32+JU+J8+4+J9+1 « 37 

or ^ven more suggestively ' ' 

(Ix2^ + (j8x2^) + (0x2^) + (lx2^) + (ji}x2b + (lx2/') 32+j*+JJ+4+0+1 - 37 

(Note that 2^ equals 1.) Writing, the sequence in this way is analogous to 
writing 524 as 

(5xij32) + (2xija1) + (4xiji}f) = 50J?+2j8+4 = 524 • . * 

In other wc^ds, when we write 524 we imply a "place notation" in base 1)8 
such that each 'digit is associated with ^ power of 1JZ(: 5xtjj2^ 2x|jj1 / 4x10]*. 
Similarly, rewriting our yes and no sequences as 1 and f5 sequences wO' find 
that the string of ones and .zeros turns out . to be thQ plaqe notation in 
base 2 for the number being represented. 

Here are some examples. (1J3J312 means 1001 in base 2.) 



1J8J812 = 2^+2^ = 8+1 = 9 . 
11002 2^+22 ^8+4 =12 ' 
1101012 ^ 2^+2^+22+2^ - 32+16+4+1 53- 
10000012 = 2^+2^ = 64+1 = 65 



This base • 2 (or "binary",) notation can be used to represent any patte3::n If 
bitS) in an integer variable, and with some pract:ice y^u can mentally conyerjt: 
back and forth between base 10 and base 2: This becdknes important if yoi 
perform certain kinds of bit martipulatidr|[s. * 
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An important property o£ blnny representations is that 'shifting left 
or right 1« 'equivalent to multiplying or dividing. Consider these exainplest 



4-^/ihif t left 2 places 
$claS 2 - lMl2"Scl8$ 2 - iWff^b ■ 36 
eft shift 2 is like multiplyin'g by 2^ or 



4> 



places 



f — .shift left 

•b $ci8$^ - ymptw^ - 72 

• (left shift 3 like multiplying by 2^ or 

\ , I I 

11 



8) 



So a loit shift of N bit positiLni is Equivalent » to imlltiplying^ by 2^. A 
right shift of N bit positions is equivalent to division by 2" (a gjUffling 
no bits wrap around to the left end in a $cls$ of ejl-N). Thereytfcist^ 
-arithmetic right shiff^, $ars$, which is not circular but sim/ly throws 
away any bits that fall off the riglit en^ of the word: 




. thrown away 
9 $ars$ 3 - 1W12 3 " JA^ " 

This corresjxjnds to -a division by 2^, with truncation (9/2^ - 9/8 'which 
truncates to 1 ) . 

A major use of the 6^ bits held ip an integer variable is to pack into 

one word many pieces of information. For example, you might have 60 V lags" 
^set up or down (1 or 0) to indicate 6jJ yes or no conditions, perhaps cor- 

tesp<3nding to whether each of 6jJ drill items has been answered correctly or 

not^ Ctoj^u might keep fiiEteen 4-bit counters in orte word: each 4rbit 
• countipircould count from zero as high as 15 (2^-1) to keep status 5h how well 

the dtudent did on each of f i'f teen 'pJi^obl 

integer^ as large as 1JJ23: you. could sto: 

averages /in one word^ with suitable normal^ 

is .324. Multiply by a thott^andi to jnake i 

integer 'in one of the 10-bit ^qts. When 

is by a thousand to rescale it a fracti 

arrays we had exam scores ranging frqpi zero^to 100. , The nextXdarger power 
\of two is 128 (i'), 1^ we need only 7 
Eight such 7-bit quantities could be 

How do you extract a piece of in: 
example, suppose you want three bits 
slots of variable "speicj^' 



0. Teri bits is sufficient: to specify 
six 10-bit baseball battling 
^tions. Suppose a batting average 
hn integer'^ (324) and store this 
;6u withdraw tSiis integer, divide 
(«324). When \^ discussed 




bits for each integer eacion s<^&r«u 
tpred\in one 60-bit woTj^.' 



)rmati^n packed oin 
Located Ain the 19th 



a word? As an- 
of 'twenty 3-bit 



inum <3k ( spack' Sar s$ 3 ) $mask$ 7 



X X 



"X "X 



X 



X 



X 



(sp4ck Sar.s 




0 0 0 0 0 0 0 0 0 0 0 0 0- 0 0 0 7 7 (114, :..) 



0 0 0 0 0 ^0 0 0 0 




• 0 0 0 0. 0 0 0 0 ? 



ingji"/ 



• IK"- 
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The oumbep 7 is III2 (base 2x 4+2+1), so it is a 3-bit quantity with all ^ 
three bits "set" or "on" (npn-zero) . The $mask$ operation pulls out the 
corresponding part of the other wordi the 3-bit piece we are interested in. 
In an expreasion (x $ma8k$ y) the result will have bits set (1) only in 
those bit positions where both x and y hav^ bits set. In those bit positions 
where either x or y have bits which are "reset'' or "off" (jj)', the, $inask$ 
operation produces a 0. We could also have used a "segment" definition to 
split up the word into 3-bit segments. 

A 4-bit ma«k would be 15 (111l2)i a 5-blt mask 31 (llltlj). (Again, 
"segment" definitions of 4 or 5 bits could be used). You might even need 
a mask such ^'s ll^lllj, which is 55» it will extract bits locAted in' the 
five bit positions where 1.1^(1112 has kilts set. .There should'be a sin^ler 
waj?<)of writing down numbers corresponding to particular bit patterns. Cer- 
taii^y reading the number 55 does not inmediately conjure up the bit pattern 



A compact way of expressilig patterns of bits depends on the fact that 
each set of three bits can represent a number from 0 to 7: 




110^ a 4+2+0 



67j|^ 6x81+7x80 = 48+7 = SS^g 
(base / V (base .10) * , * 

sJust as. each digit in a decimal number (base 10) runs from 0 to 9^ so in an 
.octal. number <base 8) the individual^ ntHiierals run from 0 to 7. * Octal nurtbers 
are useful only because they repr^eseht a/^mpaat way of expressing bit pat- 
terns^ With practice one converts be'tween oct^l^^nd base 2 instantaneously, 
and betw^n base 8 and base 10 somewhat slower! ^ ' 



base 1^ 


base 


8 




0^ 




V ■ 


• 1 




■2- 


2', 




" .3 






.•. ., 4 " 








'i'll 




6 






1 


1. ' 7J\ 


8 


1 10 




9 


r 11 






\ ■ 12 1 


;l 


ill. 


. ' 13 




;i2 


14 • 


13 


1 5.1 



These 
phould . 
be 

m^oirjj[2ed 

\ . 




1/ 
l^^^l 
1010 
1011 

^m 

1101 



000 
001 
010 

J311 







\ 


• .1 N 


■ 

0 


■ f 'ir" 
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The conversion between base 8 and base 2 is a matter of •memorizing the first 
eight patterns, after which t:ransXating 11)3101 IJJ1 1 1J31 2 to octal is simply a. 
matter of drawing some dividers every three bits: 



lIlJJl!JJ1ll|311l1JJl 

I1.5 i 3 3 I 5 f 
What is 15335g irt b«se 10? 



153358 



84 , 
4096 


83 
512 


82 
64 


8l 
8 


8^ 

1 > 


■j 




fs 1 


• 3 


3 


5 



1x4096+5x51 2+3x64+3J<8+5 = 5853 



10 



.How about the octal version of the number 79? The biggest power of 8 in 79 
is 8^ (64), and'^^79 is 15 more than 64. In turp, 15*is lx8U7x8^, so . 

^ ' • ^ ^ • / V 

79^0 a lx64+1«8+7xl'= 1x8^1X814-7x8^' « ii7q 

Luckily, in bit manipulations the COnversibns between bas§, 2 and base 8 
'Sre more important than the' harder conversions between^ase 8 and- base/ 1j(Jt _ 




To express an octal number in TUTOR, use an initial 

X $mask$ o37 ' ' ^ ^ 

will extract the right r*most ' 5 bits from x, because o37 '= 37q = JZI111112j 
which Has 5 bits set. Naturally a number startiij^ wi'fefi tjie fetter "o" must 
rK)t contaiYb 8' s or 9' si 

You'^can disp^^^ an octal number^'with a -sl^owo- commarxd (show octal) 

" . showo 39^^^ \ 

will displafy on the screen ^(39-, ^47q) The default 

format is twenty (3^bit) octads, do^resppnding to a whole 6ja-bit word.^ 

•o ^.4 - ; ^ ^ ° . 

lay "ISIS0!^\f sh^Wing^^st four „ octads* 

NoW^ tjhat we Have diseased the octar notatiori^i it is. possible to poiat 
du^ whAt 1 happens' to neftative>yium^ers/ ' T /j 




showo^ -39 



1 • 



^'^ni^di^pla^l "777j77^ number is^^th?^^*^^ 

" rO^the positJive njjunber — binai'y 1 'I ayeN^anged to fl*s §hd bin^rjij is are 
dhang^d^to ^'s,,. tn octal,' the coliplemeivbxof J3 is 7 {01102'^ '^'^1^ '^ %^ 
the coihplement of- ^ is jJg. In the exajtriple^x^own, octal 47q iS yij3l1l2j. 
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who'se eomplemeait is 011/3/3/32' ^H'' N6tice in particular that the left- 
moBt'^it Jthe "sign" bit) of a negative number is always sfe^. In order" 
that a negative number stay- negative upon performing an "arithmetic right 
stiift", all the left-most bits are'^set. So , ^ ° 



o4SSfSfSjil5mfl0mm242 •$ars$ 6 
yields 7* Q774miSlflS0fSfSfSfS0li00^2. 



J- 



Oftly the sign bit was 'set among the lef t-most pits befora 1;ihe shi^N: (o4ja is 
1^1^^J/I^J2) # but after the shift the first seven bits are all a^*- -- Thk ^^^j vm^ift^r 
left shift", Scls$, does not do anything special with the sign b;j:t. 

\ ^ It jis intWesting to see the^ bits j set .for f loatlngipipint number^ : \ 



calc vl <p3 • 
at 1215 

write pos=<t o,vl> $$ o ^r -showo- 
neg=<l o,-vr> ' ' \ 



will make this display: 



pos 
neg 



\i2\mSimmmm 

efisiMiiiiiiiiniiii 



Note that the negative niimber is the complcflnent of the positive. The 46-bit^ 
magnitude (6!iflfi00!i!i!ififi!ill000} ' represents a huge integer (6x2"*^). f Thje elev^ * 
bits between the- sicjn .bit and the 48-blt magnitude give the power ofe two (-46) 
by which the magnitude is 'to be scaled (3 = 6>i:2^^x2"'46 =, 6x2""'' « 3). "^A bids 
of^ 2fl00Q is added ta the cprrect/exponent (-46,' or -"56g) to give aft eleven- 
bit exponent of 172I3. Exppnqnt^ less tl^n 2fili0Q represent negative powers; 
exfjonents greater than ;52ja|JJ^g represent positive powers. * 

We have encoTontered octal numbers (e.g., o327) which can be shifted 
left <$cj.s$) and f ight ($ars$) and complemfenlied (by making negative) . Pieces 
can be extracted* With a $mask$ Operation. Ad'dltional' hit operations* are 
$union$, $diff$, and "bi tent". The "bitcnt" function gives the number of 
bits set in a v^d: ' bitcnt (o2SX. is 3, because o25 is i»ljai)ai2, which h^s 3 
bits set; bitcrit(-o25) .is 57, since the complement will ha^e only 3 of 60 - 
bits notjj^et; bitcntCja) is 0, Uke $mask$, ;i$unionS .and $diff$ operate t^e 
^1 bit position^, with all \S0 done ^t once: p ' i | . * '^-^ 



individ 





produces a l! w! 
pr«<|^uces a 1 o: 



' . i I-- 
prttKiuc^Q a 1 j oiily yhQr4 both x 



lere either x or 
lly where x and^j 



^d y have 1 'is. 

y or both havjei 1'sl 
.1 £z 



differ . 

U 



V 
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Note that $unioH$ might be called I'jnerge", since 1 's will appear in every 
bit position wherb^ither x or\y have bits set. The $diff$ dpefatfion might 
also be yeferre^ toNis an "exclusive" union, since it will merge bit& except 
for those places where N^oth X and y have bits sSet. 



a 

to 



While $mask$ can be usdd to extract a piece of informati.on from a wor 
$n^sk$ that ineludes all but that Apiece followed by a j4iinion$ can* be used 
insert a new^ piece of information., - ' * 



Byte manipulation 



The most comiion use of^^ijlt manipulaiiohs is for packlLng ahv^ unpacking' 
"byties" consisting of sever^lWts from word:^ each of whiSch cont^oj several 
bytes. This can lead to major sil^ngs it^^pace. If ad ^3Chm score lies aP- 
ways between J3 and, 1J3J3, only sevenNjbits are required %o hold each score ^ 
since (2''-1) is 127. Another way to^see this is to V^ite the largest 7-bit 
quantity: IIIIIII2 177q s= lx82t7?fS''+7x8^'> 64+56+7 « 127. fHlis is one 
less than 2008 ;\Which requires an eighth t^it,,^ We cail. ;f it eigm^-bit t^tos 
intpo each Sja-l^it^ord. Happily, T?OTOR'^11 do* tlfc^e booKR^iepi^ fSfe^you, as 
we saw' earlier 




define 



ae)at,6cores3sn31 ,7 



This* definition makes .iVpoasible -l;© wo^k with, this I'segmejntedV array as 



though it were an ordinar\ a3pK;ay: 



calc 



ss <5sscore 
scores (1 
etc. * 




7) 



T)iese jfefer to the 3rd and 1 VthX^y te3 . The first eight ■7-bit bytes reside 
in n3l, with, the last 4 bits uriiiised. The n^xt ^ight bytes are in n'32, etc. 
The 17th byte is the first 7^bit\byte ih n33. " ' 



Just as we effectively give 
have r^egative as well as positive. 

positivevandvnegatiV^e^ nunflD^rs storied in a'^segment array 



ip ohe bit of a fejJ-bit word in order, to 

n^umbef s>,*'So it is possible to have both 
4, . t . 



define segment, temp*=v52 



I- 



8 , signed 



^The Word "s, 



gned 



calc ; tiSlt)pi(2S), <=l--95 

With 8-bit byt^s we can kave numb^s in the ra'nge 6f ±127* 
may be abbr|vijated by "s" 

Now that you understaifS the bjit structure of a variable, you shoulla be 
able to understand the table given earlier of segment) ranges and . number of 
seginents«pet Variable. Look at the tcible now and( see whether you can check 
the entries in the table. 1 ' • ^ 
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Alphanumeric i:o' numerics the -compute^ conmiaQd 

'"'^ The •store- commaiid ^alyzes the judging qopy of the student's response 
character string and produces a numerical result. This is actHally a two- 
step^'prdca^. First the character .string is "compiled" into basic computer 
insttu^ipns and then these madline instructions are "executed" to produce 
the JimnefcLcal resvilt. During the cdm^ilation process the; "define student" ' 
definitions and the built-in functimi definitions (sin, cos, arctan, etc.) 
are used to recognize the -meaning of^'n^es appearing in «ie character string, 
Nui^bers expressed as alphanumeric digits are converted to true numerical 
^quantities. For example, the character String 49'&ecomes a number by a 
surprisingly indirect process. The character , code for "4" is 31 sin<:e 
f'z" is 26, "^J" is |27t, etc. The char^cter^pde for "9" is 36/ The number 
/expressed by typiijig 49 is obtained f^m the 'if^mula 

1j3(3.1-27) + (36-27) *or I^K"^"-'-^')^ ("9"-"'iJ") . 

- ^ 1^J(4) + (9) , ^ \ 

. ,4i3+9 ^ , , V 

■ 49. ' - * . ' 



. ^ ^ 

reasons, the cdhipilation process is ten to a hundred 



For these and 

times slower than the execution process! - Therefore, TUTOR attempts to compile 
the student's response only once, while the resulting maicTiiiie instructions 
may be used many times. 

.The f irst .:^store-, -ansv-, -wii^gv-, -storeu-, -ansu-) or -wr'ongu- com- 
mand encountered during, judgi'iig trig^rs Compilation. All these comitvands^ 
following ^feh€L^ir St one simply reuse thfe-sCompiled machine instructions, if 



idging copv, 

7 



a following ;-store- 



^ -bump- or -pu^^^akes any. changes in the 

^^^^reilat^dKcommand recompile. s£M4.arly,^a "judge redudge" 

H}:^'\y^:6iQ^ recomj^ilation by ^ny of these conmtands. Note that re-exec^tion 
is "&wavs performed even recompilation isn't, because the Student miight 

3se values , have been alterecj^. 
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After compilation, the "pointer to machine instructions" dgntains. the location 
of the machine instructions in a special -compute- storage\area. You must 
zero the pointer at first to force compilation. TUTOR will then* set the 
pointer appropriately so that re-executions of the -compute-^ command can 
simply re-execute the saved machine" instructions. Here is a unit which \' 
peintiits the student to plot functions of interest to him: 

! • f define 

> • ' define 





graph 

graph ^ 

* $$ display the axes 

fS.2 
3i;S5 

Type a function of x: ' 
where+2 y 

T\ 



string, j coil 



x<J=poir.^^ ^ 
compute res\xlt,s^xing, jc6uitt>^ 
goto formok,x;badf orm 
locate J3, result » .$$ draw ^rom here 
doto 8plot,x<0=.1i1^f,. 1 
compiit^ result, string , j count ,point 
go tp * lEo^ok , X , bad form * 
;x insult ^ . 



badf oral 
32J37 

f ormok , . 
wrong 



$$ tell what's wrong 



can be superimposed! by changing, the rejspon^ jinsteald of 
The first ^compute- in this unoLt calculates the 

i: k equkl to ^ero. The -locatep coihman<l 
ttbris us| at io^^fcion ,resul\) so thai the first -gdraw- will dra|^ 



lej startjing^at tlhafcH^intv The\syfet«m \jariabld'"fonn|Dk" has jihe Value 
.f compilation* aw exedtt^on i^juccfeed; i f compi|lationj«sucqe^d4 but ^ 
execution fails due to sUch enrolls as trying to ^Ecd^e^^e squaresriot of » 
\a negative numberV^ and various positive integral values^^foa^^ario^s compilation 
errors (kissing parentheses, unrecognized variable names, etc. 



1 «^ 
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As another example, the PIATO lesson "grafit" (written by 
Sherwood) permits* the student to write up to fifteen statements * 
graf it language and execute his progreun to produce grapjiical outpu. 



v*t«t 




■Prmmm BACK t* e1««n kcr^vn. 



This student's program calculates the motion of a mass oscillating on the 
elnd of a non-standard springf. The two curves are the sujaerposition of 
running the program twice with different values of the parameters. The/^"^ 
, heart of this lesson is a loop through a -compute- command with string/ 
character count, an4 point all being indexed variables. The index is the 
line number, from 1 to 15, Each student response is analyzed using a 
-match-/command looking for keywords such as "goto". Then the rest of the 
response is filed xiway with a -storea- into the string storage area * 
cor r,e spending to that line number. The 15 pointer ^^ciriabres ^^:e zeroed in 
the ieu (initial entry unit) to insure that wken the student r'ettErns to 
a PLATO terminal after several days TUTOR won't be confuke4 pve^r .whether 
the strings have l^^en ^recently compiled 'or not'. Also, whenev^^the student 
changes one of his^^statements, the corresponding pointer is zeroed in order 
to force recompilatio^^^f the aPtered character string. The student ca» 
•press DATA to initialize p^raineters, LAB n:6 -Specify what variable to plpt 
,against| ^hat variable, and HELP ^ra^ description of th^ lAnduage. ^ 

The "stiudent'' define sett (iefines^'allj^^S^tters. as varica>l&^ the^ student \ 



can use. 



1 



II N * 

Built-in d^N 



Us t^en) to mean t 
' be^ . <^^^ned in t] 
belated c^nd^fiands. 



nitions tdke pfece3ence in a -compute-, ^o that Sifi(6^ 
sine- of 6, not fexi><nx,(e)/i ^en if s, i, and n Ifeve 
student fet. ^"'This is;/true *also foi: -store- and 
llowever, author'^ oWn Wf initions take prec^^c^, in a 
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-calc-, .so that, within a lesson an author .can override the normal ' meaning 
of "sin" or "wherex". Other differences already mentioned were that authpfrs 
must use explicit multiplication between names -o£ variables or functions, and. 
authors must use parentheses around function arguments. While authors are 
discouraged from using priit^tive names such as v47 eXEept_in a -de fine- 
statement, students are »ot permitted to use primitives at all. This is 
done trcrprfltect iAg -author*' s internal information. Similarly, students 
dannot use! I the assignmefit" symbol (<0=) , except in a -compute-, unless there 
is a "specs? okassign". « • " j 



It should be mentioned that while -compute- converts alphanumeric 
information into a numerical result, there i^s an -itoa- cdtanand that can 
be usid to coflvert an integer to an alphanumeric character string. 



The -find- command . ^ . ^ 

The -search- command Is character-string oriented arid w^l^l locate 'doef» " 
even across variable or word boundaries: the d migl^ be aC'the end of one 
word and the og at the beginning of the h^xt word. The -find^t command, i\x 
contrast, is word oriented. It will. find which word contains a Certain number 
or character string: ' > ' - 



find 372,n1 ,5ja,n125 
look 



for 372 



starting 
at n1 



lookiilg 



return the 
location 



through 
5J3 words 



If n1 contains 372, n125 will, return the value 0r if n2 is the first word 

which contains 372, n125 will be' 1 etc. If^Tione of the 5)8 i^rards contains ' 
^372, n1 25 -will be set to -1. Noti^ce thaj: ih -search- the Ire turn is 1, not ^, 

if the ^string /is .found *immediai:ely. This is due tg the fact that in character 
.strings we start numbering with character number 1 ; Qn the othet hand, 

here the first word is n(1+ja).. ' 

Do not use v-variables in the first two arguments of r-fin^- because - 
-find- makes its cpmparisons by integer operations. The, first ^irgument can 
be a character string such as 'dog' or "dog".v You can look at evety 3rd 
word by specifying an optional increment: • . 



find "cat",n1,5jZl,n125,.3 

o ' optional I 

; V' i I i ' ■ ' GO- 

"".This will loOki for,^"<p^t'' in nl, n4,* n7, etc., ^ and n1 
^""^or 3^ or 6, atcl Negativ^ increments can be used l^o 



thie end of the I list 



&5 would he' r0tur)i< 
searchi backwajids 





You can also specify that a "maSke<3 equality search" be made: 

find "cat",n1,5V,n.125,1,orl 

optioni 

In this case n125 vill be jsero if [(nV^iff?^^ "cat") $mask$ 077770)!] is 
zero. The mask specifies thaj: only a part "of the woid w^l be examined. 
The incremejfit must be specif ied^ even if it is one^ to avoid ambiguity ' 

There is a -findarll- command which will prod^ace a list of all the 
locations where something was found, rather thap producing locations one 
at a time. , . . / ' . ' 



The -exit- command 



relg 



Suppose you ar^' seven ^levels deep in -do-s. That is, you have encpunter,ed 
^^^eveiji nested -do- stlatements \)n the w^y to the pjpesent unit. The statement 
"exii 2" Will take you out t:wo levels. The next statement to ^e executed* 
is tl>e statement which follows the sixth -do- • A blank -exit- commarid (blank 
-tag) takes you immedia^tely to the statement following the first -do-. Such 
operations are ocgasion^lly usefu^. Notice that encountering a uoit command 
at thi end of a done subroutine will cause an automatic "^^t 1". 



\ ■ 
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X. Coinmon variables 



Th^ -commotio command ■ . ^ . 

The "stfudent variables" v1 through v^5jS are associated with the individual 
student^/^It |s possible tcJ use "common v^hriabreis" whiich a?:e jcommon to 
those, students .s£\jdyi|tg a pai?t;icujar lesson. These common varia^bles can be^ 
used to send messa^s from one' student to another^ to hold a bank of data 
used by all tihe students,^ to a<j;cumulatd statistics on stu4,ent use of the 
lesspn, to contain test; items in a compacts s1;andardiz^ f6rm, ete. 

^ As a first? exan^le of the use of common, l^t's count the number of 
students who have entered our lesson. We^^will-al^o count how many of these ^ 
students are female: . .. . ^ 



total=vc1 ,female's=vc2 



$$ two commbii' variables ^ 



common 
define 
* 

unit ask 
calc . total <i=tOtal+1 
at 1215 

write Are you a female? 
arrow 1415 
answer yet ^ 
calc Jfeawr±es<3=females+1 
answe^K*" no 
no 

write Ye=s"^M:^o, please! 
endaxrow 
at; '1615 

-write The^e are^<(s,tota3i^^.^adents, of wliom 
.<(s, females )> are Ifemale, 



V ■ 



The -cotiunofi- command tells TUTOR to set up two common Vatiablesr vcl and vc2, 
which w^ h^ve defined a^ .^'total" and "fenmles".' The^e common vari^les are 
automatically initialized to zero before the first student e^^ters this lesson. 
The first student increments "total" to jbne ("Calc totar<>=total+1J') , and 
may also increinent "fismales". *he second student to enter the lefeson causes 
."to%al'' to increase tp twp^d may' also change "females". .Each] student is . 
shown the p^es^t valueq^ of "total" and "females", Vhich depend^on What other 
tetudents ar^ .doijig,^^ We^^^ use common variables v61 and vc2 rather than .the 
s;t:ud^nt variables y1 atfd v2 because the student variables cannot be d;Lrectly 
affected |5y . actions lof l|other ^tu^ents. , Anothet way to see this is to pSint . 
dut that when thete ar^'tive students in this lesson, they share a single vcl ; 
and a single ve2,| whereas they each hkve their [own v1 and their own v2: ther^ 
are five v1 • s, andfi f ivjs V2's but only one vcl ahd vc2.] * * 



/ 
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Integer common variables are ncl » nc2» etc. » and indexed common variables 
are vgrittien as vc (index) or nc (index). ^ 

Tho statement "common 2" to lid. TUTOR to associate a two<^ord sc^t^f 
common variables with this lessom For reference purposes it is good style 
to place the -common- command near the beginning of the lesson. There can 
be only one -common- statement in a lesson. Like -define-, -vocab-, and 
-list-, the -common- command is not executed for each student: rather |. when 
TUTOR is preparing the lesson for the first student who has requested it, a 
set of common variables is associated with the lesson and all these Qommon 
variables are initialized to zero. Additional students entering the lesson 
Inerely share the 'common variables previously sot up. 

Suppose a class of fourteen students uses our lesson from 10 A.M. to * 
11 A.M. The fourteenth student comes at 10:05 and gets a m'bssage on the 
screen saying "There are 14 students, of whom 8 are female". As long as the 
lesson is in active use«each new student who enters the lesson increases 
"total" (vcl). However, when all the students lea^ at 11:00, the lesson is 
no longer in active use and will eventually bo removed from active status to 
make room for other lessons^. When another cl^ss ^omes at 3:00 P.M., the 
lesson is not in active use and TUTOR must respond to tho first student's 
request for the lesson by preparing the lesson for active use. In the 
preparation process tho statement "common 2" tells TUTOR to set up two 
common variables and initialize- them to zero. The first student to enter 
the leoson at 3:00 is told "Inhere are 1 students, of whom 1 are female". 
She is not told "There are 15 students, of whom 9 are female", despite the 
fact that tho previous student (at 10i05 that morning)' had been told there 
wore 14 jjtudonts, 8 female. The "common 2" statement will eause the common 
variables to be zeroed ever^timo the lesson is prepared for active use. 

Thg tyP9 of common which is sot up 1^ tho statement "common 2'* is 
called a tcmpo-rary common. It lasts only as long as the lesson is in activo 

and its content^ are initialized to zomt whenever the lesson is moved 
from inactive to active status. Temporary common can be used for such things 
as telling tho students how many students are present, what their namos are, 
and whether a student who has finished a particular section of the lesson is* 
willing to leave his terminal to help a' student who is having difficulties. 
Messages can be sent from one student to another through a temporary common: 
just store the mes8i\ge in the common j:irea with an identifying number so tha^ 
the appropriate student can pick up the message and see it wit^h a «-showa-. ^ 
The lesson simply. chocks occasionally fdr the presence of a message. 

, When a student signs out you usually want to change the temporary co^hmon 
in some way. For example, if* you are keeping a count of the number of students 
presently using the lesson, ^you increase the count by one when a student 
signs in and you decrease the count by one when tho student leaves. The 
«>finish- command lets you define a unit to be executed when the student presses 
shift-STOP to sign out: , >K 

finish decrease 

r unit decrease 

calc count ^count-1 



In this ease unit ;'doeroase" will be done each time a student signs out. 
Normally the rfinish- eommanja s/hould bo. put 'in the ieu (initial entry unit) • 
As with -imain-, the pointer sat by the -finish- command is not cleared at 
each new main unit. A later -finish- command override^ an earlier ono, and 
"finish q" or a blank -finish-^ statement will clear the pointer. As with 
all unit pointer eommanda, -finish- can be conditional. Only a limited 
amount of processing is permitted in a -finish- unit to insure that the 
student can in fact sign out promptly. 

We can keep a pemuknenfe, On-going count of students who enter the 
' lesson by'usi^g a permanent eoitunon. Instead of writing "common 2", we 
write "common Italian, counts, 2", where "Italian'' is the naitto of a permanent 
lesson storage space and "counts" is the name of a cocmnon block' stored there. 
This is the same format used for character sets (the -charset- coninand) 
and micro tables (the -micro- cownand). When the conmon blook is first sot 
up in the lesson space, its variables are initialized to zero. Let's suppose 
that the fourteen students who cojno in at ^0:00 A.M. are the very first 
students ever to use our lesson ♦ The statement "common Italian, counts, 2^ 
will cause TUTOR to feteh^ this (zeroed) common block from permanent storage.' 
As before, the fourteenth student arrives at If :/l5 and is /told "There ^tre 14 
students, of whom S are female'^t At A.M. these students leave anfl our 

lesson is no longer in active usp. At some point room is needed for other 
active lessons (and commons), at Iwhich point our permanent common, with its ' 
numerical contents of 14 (students) and 8 (females) is sent back to permanent 
storage. At 2i00 P.M. the first student of the afternoon class causes TUTOR 
to prepare the lesson and fetch the permanent common from permanont storage 
without initializing the common variables to sero^. The result is that she 
goto the mossago "There are 15 students, of Wm 9 are feigalo",* 

The- key feature of permanent common is that it is fetched f ifom storage 
when needed and returned in its altered state to permanent storage when the 
associated lesson is no longer active, m our case we could enter the lesson/^ 
months ^fter its initial use and see the total number of students who have/^ 
entered the lesson during those months. Other uses of permanent common 
include the storage of data bases accessed by the students, such as population 
data in a sociology course or cumulative statistical data on student perfor- 
mance in the course. - ' ... 



Before discussing additional applications of common variables, it is 
useful to describe the, "swapping" process by which a single computer can 
appear to interact with hundreds of students "'simultaneously". The'compMter 
actually handles students one at a time but processes one student and shifts 
to another so rapidly that th&lstudents seem to be serviced simultaneousli/. 
In order to process a student, his lesson and his individual status (including 
the variables v1 through v150) must l^e brought into the "central memory" of 



There is now an --initial- command A/hich can be use^ to define a unit to be 
executed when the first student references the common. This makes it pos- 
.sible to perform initializations on a permanent commorf. 



The swapping process 
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the computer, Aft^^^ f ew thousandths of a second of processing « ^the 
student's modified status Is transferred ojat of a central memory (to be 
used ag^fln later) and another student's lesson and status are trahsferred 
inU^^ centra^ memory. This process of transferring back and forth' is called 
^^ewapplng", and the large storage area where the lessons and status banks 
are flield Is called the "swapping memory". The swapping memory must be 
large enough to hold all the status banks and lessons which are in active 
usQ;]|that 4s, in use^by students presently working At terminals. It- is not 
necfessary for the swapping memory to hold in addition the many lessons not 
presently in uBe nor the status banks fqr the many students not using the 
con^utejr at that time. These inactive lessons and status banka are kept 
in a still large r "permanent storage" atcer»^ 




fTwemory 



Central 
memory 



Hur>dr<!<jls of act}v« 
I eaaon^t ait i v€ 
atudcni; atatua* 
banks. 



Qds lesson. 
Qofl atuctant 
•tatua bank. 
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When a student sits down at a tjenhinal and identifies herself as 
"Jane Jones" registered in "french2al"# her status bank is fetched from ^ 
permanent storage to see what lesson she was working on and where in *the 
lesson she left off last tinie. If the Ifejsson is already in the swapping 
memory (due to active use by other students) , Jane Jon^s Is simply connected 
up to that lesson# and, asvShe works through the lesson* her lesson^and her 
changing status bank will be continually swapped to central memory. If ^ on 
the other hand, the required lesson is not presently in active use, it must 
be moved from permanent storage to the swapping memory, ' (This involves* a 
translation of the TUTOR statements into a form which the boittputer can ptocess 
later at high speed,) This fetching of the inactive lesson from peniuinent 
storage to prepare an active version in the swapping memory will typically 
be done once in a half-hour or more as , the student moves from one lesson to 
another. In contrast, t^he swapping of the active lesson to central memory 
happens every few seconds as the student Interacts With the lesson. Therefore ^ 
t the swapping transfer rate must be very high whereas a low transfer rate between 
permanent storage and the swapping memory is adec[uate , . 



IT 

"f: 



195 



X - 5 



When the student leaves for the day, her status, bank is transferred 
from the swapping memory to permanent storage. .This makes, is possible for 
her 'to come back the next day and restart where she left off. ' 

.i! : The question arises , as to why there are three different memories: 
central memory, swapping memory, and permanent storage. For example, why 
not keep everything in the central memory where students Can be processed? 
It turns out that central memory is extremely expensive, but permanent ■ 
storage in the form of rotating magnetic disks is very cheap. " Why- not db 
swapping directly %)etween permanent storage aind central .memory? The rate 
4t which lessons can be-.fetched from permanent storage is nluch too Slow to 
-keep the computer busy: the computer can .handle only a small number of 
students because a lot of time is wasted Waiting for one student to be 
swapped for another. If the cost of the tooJhJsuter were shkreS by a small 
number of students, the cost wojjld be prohibitively high. In ordlr to 
boost the productivity of the computer, a special swapping -meinory is used 
which permits rapid swapping. This minimizes unproductive waiting time' 
and raises the number of students that can be handled. The swapping 
memory is cheaper tha^i central memory but considerably more expensive than 
permanent storage. J , i 



There is, therefore, a hierarchy of meitjoriea^rced on us by economic 
and. technological constraints. The expensive, staall central memory is the . 
place where actual processing occurs, ai^d tl^ere is never more than one student 
in the central memory. /Material -is swapped iback and forth to -a large - 
medium-cost swapping memory whose most/'impoiftanir feature is a very* high 
transfer rate to central memory. Permanent storage is an even larger and 
cheaper medium for holdiny-the entire-set of I lessons and student status banks. 
It has a low transfer rate to the snapping memory. . >- 
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Cbromon variabtle^ and the sWapping process 

Now it is possible to defecaribe more precisely the effect of a rcommon- 
statement in ^ lesson. Just a^ an individual student's les3on and status 
bank (^including the student variables y1 through v150) are swapped betw^eJi' 
central memory .and the swapping memory, so a. set of common variables associated., 
with t^e lesson is swapped l^etween central memory and the swapping memory, r 
There isf. in central memory ^n array of 1500 variables, called vcl through 
VC1500V in'tip and out of which a set of common variables -is . swapped. As long 
as the. -coirtiabi^ sta^iei^erit specifies a set of no more than T500 common variables,^ 
this set will-automatically swap into and o\A of the central memory array 
vcl to vcl 500. \iCShere is a -comload- command which caii be us^d ^to specify 
which portions of ^^ommQn to swap if ti^e common contains tnore than the 1500. . 
variables which will fit in pentral miemory.) All 1 500 variables in the central I 
memory arrajr are set rto ^ro before bringing a leSspn, status ban'k, an^ dommoh 
into central memory, /so that any of\ these variables not loaded by the common 
will be zero. 



Swapping memory 



st udent Jane 



a tiident P 1 1 \ 

I I 




stu<:;lent 'Nei 1 



a I esson 



a common containing 
Ltp to tS00 variables 



saaon area 




entral jnemory 



^ Note that the student Status banks and coi 



/of central memory in Order to retain any change 

in central memodp/- On the other hand, lesson^ / 

but are not sent back since no changes are made 

has to be copied into but not* out of central mjs\ 
' modifiable status banks and commons frpm the i;inci(anging lessons makes it 

possiljle for a single copy of a lesson to seryfe many students. 
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are swapped in and but 
de during the processing 
brougl\t into central mfeiijory 
tlfie lesson. *A lesson 'ojily 
The separation of the i 



It isi. dangdVous to use 
use vc-variables outside the 
yc^ when there is a "conunohj 
consider this sequenqe 4.n* 



This will. show 0, 
material to be 
other students are 
a'll the vc-variabi 
take on* many diffj 
a:^e processed, 
through vcSjJjJ 
seconds » so 
shown (Unless 
was proc$sse] 
variables 'V 
s'e(^aence 




iables without;' a -comm6ri- 'stat^ent or to 
J loaded by *tiife comnfon -(e.g. , referring to 
•atemei;^ in.tbe leayson) . Epr exany)le, 
I which has'' no -common-^ statement « 



The ,pa*jse 2" gtateSi^ftt catises tUfk student' s 
to the swapping memory for two s4condi while l^iany 
Issed. men jae is ^^vapped back iht<i^central memory, 
^e zeroed. As matter of fact, vc735 may temporarily 
values during those two seconds as different students 
other hand', a "tfofnmon 800" would insure that vcl 
Mo^^!!I ^" ^® swapping -memory and restored after two 
18.34 stored in vc735 wciuld again be available to be 
been chaijgfed by a Student.^using 1^ same, common who - 
the two-second wait) . Similarly, because the student 
VT5^ are part of the swapped student status bank, the 



v126<j=3.72 

2. 

vi26 
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The fact that common variables are shared by a^ students^ studying •the 
lesson is extremely useful but can cause difficulties if you are not careful. 
Suppose you want to add lip the square roots of the absolute values of 'vc1j3l 
through vc1j30j3: ' 



> 



caic 
^,oto 

;8sum 
show 



total <>J3 

8sum, index<*=1j31 , 1J3J3J3 

total <=total+ [abs (vc (iiideH) ) ] • ^ 

total 



This iterative calculation will take longer than one "time-slice", the 
computing time TUTOR gives you before interrupting yoUr prop^ssing to 
service other students. You are swapped out and will be swapped back into 
central memory later to continue the computation. It might take several 
time-slices to complete the computation, and in-between your tjjne-slices 
other students are processed. This time-slicing mechariism insures that no 
one student can monopolize the computer and deny service to others. 
Suppose two students, Jack and Jill, are studying this lesson and' sharing 
its common. Suppose that Jack has reached, the parf^f the Wesson- that 
contains the -doto- shown above. If, at th4 same time, J;lll runs through 
calculations that modify vcl/JI through vc^000', her modif icatioi:\s will be 
made during the interruptions in Jack's processing., The total that Jack 
calculates- will, therefore, be based on changing values and will not be 
the total at a particular instant. Jack calculates a partial total i Jill 
makes * some^ changes; Jack continues in the -dpto- to calculate some morej 
then Jill makes further changes, etc. At the end Jack has a peculiar total 
made up of partial totals made at different times. Even more drastic things 
will happen if "total" is itself a common variable: Jill might do 
"total <=J3" right in the middle of Jack's summation! 

If it is necessary to get an accurate total at a specific instant, it a 
is necessary to lock out Jill and other students from modifying common 'until 
the totaling is complete. The idea is 'to set a common variable to -1 before 
starting the calculation, then reset it to 0 upon Completion. Whenever 
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modifications are to be made, you check this "lock" to see thati it is « ' 
Sens"Se"L^? -t-ctu- thi.! ;!t; v' . 



[do lock 
make "] 
roodlficationsj 



do 



unlock 



unit 


lock 


8chk 


vlS^fOvcl 




vcl <!3-i 


branch 


v15jef,x,8ok 


pause 


2 


branch 


8chk 


8ok 
* 




unit 


unlock 


calc 


vc 1 <^0 



$$ get present lock value 

$$ set lock if not already set 

$$ fall through if lock was alxeady set 

$$ wait two seconds^ V 

$$ try again * . 



clear the lock 



If 



r^^^rj^ 0, we set it to -1 and make the modifications, theh reset it to 0 
vc-TTs -1, we superfluously -set it again to -1 biit fall th^rouqh the -hrf^nh 

modifv^S JH^"" ""^^ ^^""^ ""^"^ ^^^^ 1°^'' if the student who is 

S foi;;^ 1?°"™°".'"?"" completing the modifications! Otherwise 

the common wxll remain locked and other students will be hung "up forever 
waxtxng for the lock to .clear. One good way to do this is ^o keen SIS 

wir^v, • *=station". The system variable "station" gives an inteaer 

whxch xs unxque to the terminal. For a student at terminal IS! "SaW 

JeLSal ThI ^'"^r "^^-^-"'•h- value 472 for the stud^^t T 

terntxpal 472. The fxnxeh unit should then contain i - 

qalcs vc2=station,vc1<}»JJ,vc1" so that the lock is cleared onlv ]f Vk^ ' 
station was the one which, had set the lock' cleared only 4f this 
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The use of v150 in unit "lock" is importc 
version of that unit which will not « work properly j 



Here is a different. 



unit lock 
8chk branch 
pause ' "2 
branch .8chk 
8set vc1<3±-1 



vc1,x,8set 



$$ check lock 
$$ wait two seconds 
$$'try again^^' 
*$$ set^J^odTc 



Suppose the lock is clear: vcl is jl. Thejr the branch is to label "8Set" 
where we se;t* the lock ,(vc1<^-1) and procjrec^ to modify the cononon. Unfortunately, 
we might get interrupted during the br^aCnch oper^ation, in which case another 
student would also "find vcl 'still equal to jl, set it, and proceed to modify 
common. When we get another, time-slfice aft:er the interruption, we blithely 
r set vcl and proceed to riiodify comrton ourselves. , Now we hat^e two peoplev 
modifying common, which is just vmat we were trying to avoid! , ^ 

o * The version using vlS^f do&s not have this problem because TUTOR will not » ' 
inrfcerrupt processing in the miiddle of a series of -calc- statements which 
do -not involve -branch- or -doto-. This makes it possible to transfer the 
curreoit value of the lock into v^50 (vl5^f<J=vc1 ) and set the lock (vc1f$=-1) 
without any 'danger of interruption between these two operations.' On the 
othe'r hand / TUTOR ' may , interrupt on any* -branch-, -goto-, -doVq-, or simi-^r 
; bxanching .command. The amount of the allowable time-silipe^ used ..so far is \ 
^h^^^ked on these branching operations in order to pr^ent infinite loops .\ 
such as "8here ^brancH Qhere". This time check is^ performed on many 
TUTOR commands, especially commands which might require a .lot of ^processing 
time. The only safe non- inter ri^ptable situation is within a non-branching 
-calcr.- (In addition to tjime check's, TUTOR also makes checks for too muq] 
display material stacked Up waiting to be sent, to the terminal. TUTOlR 



inserts, a -cat(ihup- commaad 



if necessary.)* 



Npte that ^ 3^ock is needed only if different students are storing 
informs^tion into trie same ^rea of common. There is no jDroljlem with haj|ring /\ 
differjbnt students reading 1 information out of the same area of common or 
^ storing information in different areas of common, Logical conflicts aris^** 

only ip modifying the same part of common. Even in this case there is problem 
in many typical cases. In ^the example of counting the number of studeiits . 
in the lesson/ we simply exfeeuted "vcl <S=yc1 + 1 " , which cannot cause any ' 
prol?lem because all of the modifigations a^ completed in one nbn-interruptable 
-calc-. » 
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Instead of using "pause| 2" to wait for the lock we could use "return". 
The -rbturn- comrfiand has no tag. It means "return control to the cOmputier — 
: give m^ another time-slice as soon as possible after servicing other studentb". 
A -^retm;pn- or -pause- can be placed just ahead of *a small amount of branching 
^ computation to' insure that tliis computation starts; at the beginning, of a 
time-slice. This insures a iioderate amount of non-ihterrupted branching . " 
computation. For example, a;-return- at the beginning of unit "lock" would 
* make thb version on this pag^ wo^k properly. 



* There may be. changes in these interrupt rules. It is^ strongly recommended 
not to use the lock techniques discussed above. Instead, use the new ' 



-reserve- and -release- commands.. 
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The -storage-' command ' i 

certain applications 150 individual student variables are not 
sufficient, even using segmented variables. It is possible to set ud extra 

llZXullZotZ "'."""'^^ '° ^'^^ that are " . 

rSrilocr^sS Ja"riabirt; be '^^l^: ^^^^^^^"^ ^^"^ 
^ i_ ^ vai. j.ajjj.efc> to oe set up m tdje swappma memorv for 

Sf^"e^Sted" ^i'^- —on-, the -storage- comf^nd is 

not executed , it is rather an instruction to TUTOR to set up storaae 

varLS: ^^""^"^ 1— temporary common? t^ st^r^ge 

variables are zeroed when the storage is set up. 

A -|transfr- command can be used to move common or storage variables 
from swapper mem'dry, into the student variables or into the "vc" Sea Usually 
'however, common is loaded automatically into the "vc" area i? ^h! ™ ^' 

i:rrofX T ^ con^anTmurt b:^::;^ II Sc r^Mch 

vcft^oXh vct500 ^T°;?h" '° ^%--PP-^ into and out of Which sdd1:ion of • 
TiL TttlV /' the case of -storage-, there is no automatic swap- 

to L fnnJ; r " "^^"^ ^P^^fy "h^^ P^^ts of the storage are 

to be mov^d into what area of the^ "vi:" variables. Here is a typical tamjle: 

common 1000 » \ 

storage 75 > j ' 

stoload VC1001.1.75 " ' " 

The common will be automatically swapped in and out of Vcl through vc1000. 
The 75 storage variables will be swapped in and out of vc1001 through vc?i75 \ 
_Jt xa_g^od_form to define all these matters: - vci^/5,\ 

define comlong=1000, stlong=75* 
/ - stbegin=vc (comlong+l ) \ 

/ . (etc.) , 

/ ' common comlong 

storage stlong • • 

stoload stbegin.l.stlong 

■ " calc stbegin4=37.4 . 

While -common- and -storage- are "non-executable" commands, -comload- and 
-stoload- are executable, so that swapping specifications, can be changS!- 

The student's current variables v1 through v150 are saved with other 
restart information when he signs out. When he signs in thl nexf dav Sec. 
variables, therefore, have the' values they had wh4n he LfJ: storage' 
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variables are not saved, howeve jr. All sto^-age-variaQDles are Initialized 
to zero when t^he "storage blopk is set up upon entry into the lesson, as 
with temporary cpnanon.' If it is necessary to file away more than the standard 
15JJ student variables i ypu;could ;split up a common into different pieces 
for individual stude,ntsl!: F6r example, if you 'need to save 200 extra 
.variables fox: no mor.e than, 2jJ, students, you could split .up a 4jZfjJjZf-variable' 
common into 20 pieces each containing 200 variable^. An alternative is 
"dataset" operations, currently experimental, which will jaermit you to 
control directly the transfer of 'blocks of individual data between, the 
peifmanent storage (magnetic disks) and the swapping irfemory.^ 




I. Wiscellahy . \, 1 

LittirflLS^f^-^'' will adert you to additional features of TUTok" and PLATO. 
Lxttle. detaxl xs gxven/ See appendix A for sources of additional ^^forma^ion. 

"Other terminal capabilities ^ . , • > 

. We have emphasized the keybdard and plasma display panel as the mairv 

xnput and output devices used in communicating with the student lihTr ^ 
devxces which may be used include a Projector oC color photographs T 
touch panel, ^ random-access audio playback devLe/and othSwLk ' 
^TXT'^' . °^ terminal-assocLted .J^ZeT^^^X . ^ 

^ ^os^i^l ^tt^l1S,,f^^^ ^'^^ and transp^ent, which makes it/ 

Zitl t, P^°3f t photograp^is -on the back, superimposing color photographs ~ 
wxth plasma-panel text ind line-drawings. -There exists a microfiche pro- 

i!th frfbtiS;:i T° f "^'^ ^"^^^■'^^ °^ 256 coJo^ photos, 
"iil^rS ^ ° u"^ ^-^^^ of t'hese 256 pictures. (A 

cai be L'^! ^ ""^''^ °' "^"^'"^ "^"y tiny pictures.) .Microfiches . 

inseS K °^ ordinary 35-mm slides.- - Students or teachers can 

stSLd Thf "?idf' ^-""i'^al for- the subject to L 

S^udxed. The -slide- command selects any pf the 256 photos: "slide 173". 

peiiif thfi 'V^'t -^^^^"--^ options on ?he -siide^ co^nd 

permxt the independent control of a shutter in' the projector. ^ 

hotizontarSrSSf which puts' a grid of -16 vertical and 16 

t ^^^^^ just in front of the plasma panel" When a 

. studeht points at the panel, h^ breaks- a horizontal and ^^^r?icil*be^ ?he 
information as to which beams '.were broken is sent, to the Comp^tlr aH* 



*'key", and. the lesson can use this information to move a cursor, choose 

a topic pointed at/ etc. The system variable "key'/ contains the information: 



unit . 
next 
bnable 
pause 
goto 
write 
. unit 
write 

unit 
calc 

write 



unit 
write 



,getkey 
getkey 



{key $ars$ 8) ,x, keyset, touch, ektin,x 

Itnpossiblel 

keyset 

You pressed a key 
cj'n the keyboard* 

tl>uch ' , 
xb=(key . $ars$ 4) $mask$ 617 
yf=(key. $mask$ o17) 
You^^uched location 
x= <i[s>x> ,y=r <(s,y]>. 

extin 

Tfie e3Cternal injfcit ' « 

was <s,key $m^fe$ o377]> 



The -enable-r command permits touch inputs as well as inputg from "any device 
conhected to the extern/al input connector at the back of . the PLAT^ t^raiinal. 
(The external* input 'deyi^re might bej a^^ temperature sensor, an .analog- to-digital 
converter, ^^*) Without an -enable- command these inputs are ignored. A 
-disable- corjjpneihd willAalso cause inputs to be ignored. Tlie ^^ystem variable 
"key" contaifts a 1j3-brP integer (see bit manipulations in chapter IX): the 
most significant or l^ft.-^most two bits identify the source of the key (0 
for keyset, 1- for /touch panel, 2 for external .input) , and. the least significant 
or right-most eight bits contain tpe acti/al data (which keyset button , which ~ 
tpuch panel beamf, what Ixternal d^ta) . In the case of the touch panel, ^the 



eight data bits (contain four bits. 



of X andfr four bits of y to specify a position. 



If an -enable- command is plajCed jUst after an -arrow-, .touch inputs 
can be accepted. There ifs a -touch- judging ^ command who^e tag specifies a 
screen location and (optionally )f a spatial r tolerance: \ 

"touch location, tdierance" . "fhe -or- commandos particularly useful he^re: 



touch 1215 
or 

answer book 
write 



Yes, "libro"m^ans book. 
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The student" will get the same message whether he types "book" or points at 
a picture Qf a book displayed at location 1215. (The -or- command can be" 
used. to make synonomous any judging commands; The system variable "anscyt' 
will be the same for all judging commands linked by -or-*) 



. There is a random-access audio .device which stores twenty minutes of 
speech, music, or other sounds. Segments as short as onfe-third secondv can 
be accessed in a fraction of a second, no matter where the segment is located 
on the twenty-minute magnetic disk. As with microfiche, students cAn changp 
the disks themselves. There is a -plav- command to choose a section of the 
disk to play music or talk to the studer\t. , ' 

Other devices can be connected to the external output cpnnector at the 
back of the PLATO terminal and controlled witft^ the -ext- command. The -ext- 
command can send up to sixty 16-bit quantities per second to a device. Among 
the interesting devices using this capability is a 'ImusiC box" that plays 
four-part harmony I \ ^ , 

Student rfesponse d^ta 

' . ■ -i 

A crucial aspect of TUTOR on the PLATO system -is that student response 
data can be collected easily to aid authors in improving ^.essons. Detailed 
information can be collected: unanticipated "wrong" responses (which may 
have be^n correct but inadequately judged), requests for help, words 
not found in ^ -vodabs-, etc. Summary information can also be collected: 
amount of time spent in an' area of a lesson, number of eyror^ made, number 
of help requests, etc. These detailed and summary data provide an objective 
basis for revisingl lessons. n . 

A -dataon- command in a lesson turns on the automatic data collection 
machinery. Students registered in courses with assopiated response data 
files w;Lll have their responses logged in their data files. When registering 
students in a course, specific data .collection "bpl^ions can be ^:hosen''. For 
example, one might collect only responses judged "no" (unanticipated incorrect 
responses). Anticipated correct responses (judged "ok") and anticipated 
incorrect responses (judged "wrong") would not be logged. This is often 
done because the anticipated responses are precisely those- for which the 
lesson is already replying in a detailed* appropriate manner to the student.- 
Here we see the difference between 'judge "no" (unanticipated) and judge 
"wrong" (anticipated). In this connection, -wrong-, -wroikgv-, and -wrongu- 
make a "wrong" judgment, whereas the -no- command makes^s-Sno" judgment, 

I y 

The -area- cQmmand is used to subdivide a lesson into sfections, each 
of which will produce an area ^summary in the d^a file. Each time the student 
encounters another -area- command,, a summary of the previous area is placed • 
in the data file. The area summary includes student name, area name, amount 
®f ' time , spent in the ;area, number of -arrow-s, number of ok/wrong/no responses, 
number of helps requested and found, etc. These summary data make possible 
statistical treatment of lesson data which can pinpoint weak^reas. 
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The -output- and -outputl- cpnunands permit you to write your own ^ 
information and messages into the datafile. This siippleijtents the automatic 
data logging invoked with -dataon- and -area*, , i . 

^ ■ ■ .. 

While »LATO provides a standard mechanism for looking through data files 
(including /sorting the data) , you can also read back this information and 
process i/youifself . For example, the -reada- command will read area 
summaries, V^and the -readl- command will read -outputl- information. 

Routers and, - ji 

A lessojJ^can be designated to be a "router" which routes students through 
the many lessons .making up a complete course. A router is associated with 
a course. Students registered in a course which uses .a router will upon 
sign-in be sent first to the router, not to the lesson specified by the restart 
information. A typical router might ask the student, "Do you want to resume 
, studying the lesson you last worked on?'|pif the student says yes, the V 
router executes a Vjumpout resume", which means "jumpout" of this lesson 
into the lesson mentiope^i in the tag, with "resume" having the special meaning 
"resume at the restart point^'. If the student, says he does not want to 
resume, the router might offer the student an index of available lessons. 
Suppose the student choosey a lesson on the list whose name i6 "espnum". 
Then the router does a, "jumpout espnum" to take the student to that lesson. 
(The -jumpoulf- command can' be conditional.) Upon completion of 
lesson "esp-hum" (by "end - lesso*h") the student is brought back into the 
router.* The router might then ask the student what he wants to do next, or 
the router might immediately take t:he student to an appropriate lesson. 

Generally speaking, -jumpout- commands should be placed only in routers, 
not in instructional lessons. Following this practice insures that lessons 
can be plugged into routers on a modular basis. An exception exist^ in the 
case where one instiructional package is spread ovfer two or three physical 
Wessons; in which case -jumpout- is used to connect them together. 

A router can use up to fifty "router variables'" (vrl through vr50) which ' 
are not affected by the instructional lessons. These 'can be used to keep ^ 
track of which lessons have been completed,, how many times they have been 
reviewed, how much time was spent in each- lesson, etc. 



Instructor mode . 

Authors write and test lessons, and students study lessons. Instructors 
choose lessons from the library of available lesso^ to make up a course for 
their students. Instructors also register students, monitor their progress, 
leave message^ for the class or for individual students, etc. There is an 
"instructor mode" which makes it easy foi: instruct^r^ to do these things 
without knowing the TUTOfe language. The instructor mod^ is^^sed on a router 
together with a mechanism .for setting up a roster of stu^ntsN The options 
available through this router are sufficiently flexible to make Xt unnecessary 
in most cases to write specialized^ routers. \ N 
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* If the lesson executed a -score- command, the router can use the corresponding 
value of system variable' "Iscore" to help decide how to route the student^ 
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Special "tenn»" . ' • 

Authors have a number of special "terms"- to hblp them in curriculum 
dfevelopment. If you press TERM and typo "step", you can stjep through your 
lesson on^ command at a time, (A continued -calc- couxits as one command.) r 
This is enormously helpful ih tracking down logical errors in a lesson* Aftei 
each step, you can check the present value of student variables. At present J 
yoy cannot step during the judging state. The judging state is completed 
and a switch ^made to the regular state before the step mode 'resumes.* There 
is also a *step- command which will throw the lesson into- the step mode. 
The stop features are operative only for "authors testing their own lessdns. 



TERM-curspr provides you with' a cursor which you can move a>x>und the ^ , 
screen using the "arrow" keys. Press f for fine grid or g for gross (coarg^) " 
grid. Also press f pr g to update the display of the current cursor location. 
This facility is useful for deciding what changes to make in the positioning 
of displays on the screen. " f 

■ ■ ' ^ ^ . I 

TERM-consult, notifies PLATO consultants of your request for help. When » 
a consultant become available, he or she vf ill talk to you by typing at^ the i 
bottom of your^-screen. ' The consultant fias* oh his. sqreen the same display 
you have on your screen. It is •as though the consultant were looking oyer 
your shoulder as you demonstrate the problem. You can talk tg tjie consultant 
by typing sentences* at -arrow-s or by hitt:ing TERM and typing. (If you presS 
NEXT/ your sentence will be taken as a -term- to look for in the lesson. You 
can use ERASE to erase the line an^ type Something else.) The consultants 
not only know TUTOR well but have a great deal of experience in helping authors, 

TERM- talk asks you for the name of the person you want to talk to, then 
pages that person if the person- is'' presently working at a PLATO terminal. The 
person called accepti^ the call by hitting TERM and typing "talk". The two- 
of you can then talk to each other at the bottom of -the screen, but neither 
of you can see what is on the rest of the other person's screen. you want 
the other person to see all of your screen^ press shift-LAB, which puts you i 
into a mode similar to TERM-consult. . ^ 

TERM-calc provides a convenient one-line desk calculator at the bottom 
of the screen. Authors get Jiormal, octal, and alphanumeric results. To 
avoid confusion, students who use TERM-calc are not shown the- octal *and 
alphanumeric displays. 
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* This restriction ha% been removed. You -can now step tfirough judging commands. 
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Where to get further information 
List of TUTOR conunands 
,List of built-in -calc- functions 



Appendix A 
Appendix B 
Appendix C 



' Appendix; 
V Where to get furtliier information 



The document "Summary of TUTOR Commands and System Variables" by 
Elaine.Avne^ lists each TUTOR command and gives the basic form of the. tag/ 
ana notCQ aijy restrictions such as maximum number of .arguments or maximum 
Mength of names. Lesspix "aids" available on PLATO provides detailed inter- 
active descriptions of each command, as well as a wealth of other information 
useful to authors. 

Lesson "notes" on P^TO provides a foruih for discussing user problems. 
YOU can vnrite notes to &m questions or to suggest new features that vrould 
be helpful in your work. You can read notes written by other users, including 
replies, to your hote^. Relies from consuitants/ to programming questions 
gqnerallx/appear within ona day. - (For fafet^r service, use TERM-consult.) 
Art extremely important sectl^jon of "notes" 'is the list of announcements of 
new TU^TOR features. Check 1%is sefitionXregulairly for announcements ' of new 
TUTOR capabilities. The ann^juncements a£^ followed within a few days by 
detailed desorj-ptionp in "ai^i^". \ ' 

' - " ' / 

Sometimes "taotegf will artppjuhce a chan^ in the - TUl'OR'^language involving 
an automatic conVfersion of ekisting lessons^. For example, there used to be 
several dif f ©rent \commands (line, liner figure , and^ figuref) for doing what 
•»draw- now. does. When -draw- «/^is- implemehted, all existing PLATO lessohs 
were run through an automatic conversion/ routine to change the old commands 
into appropriate -draw- commands. « It i^ 'probable that othePsuch ref indents 
will be made in the future. Therefore,, be" sure to V- 



READ NOTES AND AIDS FOR CHANCJES 



th^ may have occurred since the pv^Hpation of this book! The publication 
dat^ on the title page of this book tells ydti where to-staast looking in the 
chf-oho logical listing of new features maintained in -^^tes^ \ 

It was indicated in this book that additional judging aji^^graphics ) 
capabilities will probably be added toV TUTOR. There is^Lp"^rk in progi-ess 
to broaden greatly the handling of array^ in calculations t§^include matrix 
manipulations. Look for such things in "hptes" and "aids", ■^i^ j 
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liist of TUTOR iCoitinands 
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Calculation's 

calc 
calca 
calcs 
define 
do, 
exit 
doto 
goto 
. branch 
trans fr j 
zero / 

randu * . 
setperm 
randp 
remove 
„ modperm' 

pack ^ 

move 

search 

compute 

itoa 

clock 

name 

course 

date 

day. 

find ^ 

flndall 

common 

comload 

storage 

stoload 

return 



unit 
entryl 
nextn 3w 



next 
back 
help 
datfa 



rt 



do 

^ii 
gotc 
jump\ 



sludent Re^|3onses 

arrow, endarrc^w 
long ' 
jkdy 

coj:y,edit 
force 



answer, wrong 

list 

con cept 

voc abs,vockb 

an£v,wrongv 

ansti,wrpngu 

exact, exactc 

touch 

ok , no , ignore 
, ans 

match * 
3p^cs 
or 

stdrea 
^tc[ren \^ 
store / 
storeu / 



Othe 



ju^ge 



V 



]oxn 



bump 

put,putd,putv 
loada 

■ .• 

okwordy njSword 



paus^ 
cat<jhu: 
time 
step $ 
keytype 
groujd^ 

inhibit 

enable 

disabl4 

dataon ■ 
area 
output 
output 1 
reada 
^readl ' 



V ERIC 



211 



B 2 



Additional TUTOR comnands not discussed in this laook 



abort abort normal updating of common or student record 

addl add one to a veuriable 

allow allow em instructional lesson to use router common 

altf ont upe alteiniate font for all writing 

ansva \cnaracter string iaatch td sifudent response i 

backgnd run lesson at lower priority 

change. change comntand names (e.g.^ to French or Russian) 

chartst check whether charset already loaded >. 

close IdlkQ -loada-* but takes one characte|r per variable 

dataof f turn off student re$pohse,^da^ collection 

dataop lijce -helpop- 

idatalop like.-helpop- 

\delay timed blank output for precise display timing • 

endings specif )j word endings for -vocabs- 

Eoregnd' run lesson at nd)qp[tal (noii-background) priority 

iielpop ' provide help on th^ page " « 

^Ipopl " liicfe -helpop- " ^ ^, • ^ 

i|arrow\' Xik^ -imaln- but associated with -arrowr* , 

ixerror specify unit to go to if -calc~ error 

kiftop likd -bacl^ but f6r the STOP key 

labop -helpop- 

labldp Aikel -helpoip- 

opeh like! -storea- bu^ stores one character per variable. 

press presses, :a key for the student 

readr read ^ s€udent record for data' processing 

'readset specify a data file for -reada- and -readl- 

release , releai^ a reserved common \ 

record record a message on audio device 

reserve ^ * reserve or lock a CCTmion 

route specify router units for end of instructional lessons 

routvar set up router variables * 

score set a lesson score to be use4 by a router 

subl subtract one from a variable » , 

tabset set up tabs for *TAB key ^ 

use ' MSB sii^ions of another'' lesson to prepare, this lesson 



Appendix C 
List of built-in -calc- functions 
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sin(x) sine 

cos (x^ cosine * . ' 

arctan(x) arctangent " 

Angles are n^apured in radians. For example, sitr(45) means sine of 45 
radxans, bu|i^^ine(45 ) means sine of 45 degree/ (/1. 707). The degred 
sign (MlCROeqf) converts to radians. Similarly \ arctanCI) is .785 radians. 




which can 
radians in^ 
€N[iumber is ec 
p) is. 1.14159^... 



sqrt (x) 
log(x) 
ln(x) 
exp (x) 



srted to degrees by dividing by 1^, the number of 
gs; §rctan(1)/1^ is 45. Using the degree sign after 
^nt to multiplying the number ^y (2Tr/36jJ) . ir (MICRO- 



square root; can also be written x^/2 ©r x*^ 
logarithm, base 1JJ , 
natujiral logarithm, base e 



cibs(x) 
round (x) 
i^t(x) 

frac1tx-i 

>,^,> 
not(x) 
X $and^ y 
X $or$ y ' 

X $cls$ y 
3t $ars$ y 
X $mask$ y 
X $union$ y 
X $c^i^f $ y ^ 
bittrfETx) 



absolute value; ab^(-7) is 7 
round to nearest integer; round (8. 6) Is 9 
integer part; inti8.6) is 8 
fractional patt; frac(8.6) jfs 

produce logical values • (true=^-1 ,false=JJ) 
inverts logical values (true^-^false) 
true j:f loth X and y are true * 
true , if either x 6r y is trife (or both) 

circular left shift x by ^ bit positions 
arithmetic right sl^ift x by yl bit positions 
sets bits where bothT x and y have bits set 
sets bits where either k qr y\as bits set j(o^ both) 
sets bits where x and y di^^r\ (exclusive union) 
coimts bits 



The operators involving equality (=, ^ and^) consider tv^? quantities tot be 
equal if they differ by less than one part inrt^f^^ (relatSk% tolerance) or ^ 
by an absolute difference 6f 1^r-9. one consequence is that all snumbers 
wxthxn l/J-i* of zero are considered equal. Similarly, "infi. and "frac'^'' 
round their arguments by I^J-^ so that int (3.999999999) <iis 4> not 3, and 
frac (3. 999999999) is ^, not 1. This is done because a^tii pf 3.999999> 
IS usually due to roundoff errors .mad^. by the computer in at^feipting to 
calculate a result of 4.' The less than (<) and greater than (>) operators d 
not make these roundo^ compensations. 
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System Variables 



X 



DISCUSSED IN 
THIS BOOK 



NOT DISCUSSED 
THIS BOOK 



IN 



anscnt 

args 

clbck ' 

formok 

jcount 

key 

opcnt 

spell 

station 

Varcnt^ 

vocab 

where 

wherex 

wherey 



aarea • 
aarows 
ahelp 
ahelpn 
aok 
aokist 
aino 
aterm 
atenrin 
atime 
auno 




The third column consists of counters assp^ated wi 
/-a^ea- command. | v . 





-abort'- Appendix B . ^- 

accent marks I -5 
.ACCESS^key VIII-4'5Vin-8 
active *,lesson X-2 . . ' 

-addl- Appendix B 

alSebrait and numerical judging VIl-25 
algetirdlc VI I -27 

judging equations' VI I -30 
warning about (l/2x) VII-ai,VIl732 
with scientific ur\1ts VII-31 ' 
warning about (3+6ctn) with 
^storeu^ VIl-33 
-allow- Appendix B 
alphanumeric Information 
' -store^-^ VII-8.VII-9 \ - • • 

-showa- IV-S.VII-9 . 
10 characters' per variable VII-^, 

VII- 50.VII-55,IX-16 

difference from numeric VII-9,VII-10,. 
IX-16 ' 

• alphanumeric to numeric conversion 

* IX-25.IX-28 • V- 
alternate font Vtll-S 

unaffected by -sl2^--and -rotate- 

VIII- 7 ^ 

♦ using -char- ^and -plot- VIfI-22 
-altfont- Appendix B % 
and ($and$) logical operator VI-4 
Anderson, B. following 1-2 . 
animations II-3 c 

use of Iterative -do- IV-7 
smooth animations VI I I -7 
-ans- VII-48. . 
an§cnt system varlabll VII-17 j 
/ \zQroed when judging starts and by 
^xspecs- VII-17 
zeroed by judge rejudge VII-21 
"not changed for synonomous 
^-concept-s VII-19 
cursor mbving VI I -22 
with -or- XI-3 . 
-ahsu- VU-31.V^I-33 

warning about (3+6cm) with -storeu- 
VII-33 V 
-ansv- VII-25 |f 
-wrong V- VII-25 \ * 
in arithmetic dr1Tl\VI I -26 
with opcnt VIi-26' \ 
; specs noops.novars VII-^26 
concept/vocabs similar to 
ansv/deflne VII-27 
algebraic judging VJI-27 

warning about (l/2x)'' VII-31 
affected by -bump-, -put-, and 
^ judge rejudge IX-25 
-ansva- Apperidix B 
-answer- 1-9 

markup of errors In student response 
1-9 

with numbers VI I -10 ^ 
1 Imitations VI I -11 
notoler, nodift^II-ll 





specs VII-IV (also see -specs-) 
no caps In'tag.wlth specs bumpshlft 
VIWI 

rvnpL punctuation marks In tag yiI-12 
^6^unctuat1on' Ignored In . student 
y response VI I -34 
with -list- VU-13.VII-14 
-answetr* useful In limited context 
VII-14 • 
see -conceptr VII-14 
; Interaction with -concept- VII-17 
'With negation VI 1-24 
\ with'blank «irVlI-25 • 

^exact- compared with -.answer- VI I -34 
no condftldnaV -answer- vn-37 
using -put- to find pieces 
of words Vn-52 
-area- XI-3 ; • - 

^rgs system variable lV-11 
argtiitiehts ^ 

passing arguments tp TUTOR 
comnands IV^-S * ^ 

passing arguments to 
subrdutines IV-10 
args system variable lV-11 
warning to use different variables 
In different subroutines IV-12 
om1 tted arguments IV-l 1 
order of passing IVhJI 
passlna' arauments In 
ctfndltfonaT -do- VI-2 
pas$lif^0 a*!^9umer^ irt ^giato-. VI -1 3 
can be complicated, 
expressions tV-8JV-ir 
arc of a circle II -2 
arflrf»net1<^ ririlT Vn-ae ' 
^rtthm^tlc right shrift $a^rs$ lX-20 

artdlnegative wimtfrs 1X^23 
arrays IX-iS; 

^ with ystoreu- dlfnensiondllty VU-3^ 
warnlngpAbout defining 

V, n> vc, or nc IX-4^IX-5 
two^dinierts tonal array IX-5 
in common X-2 : 
-arrowi- I-«^,VtH ^ 
multiple— arrow-s irt a 

unit M3tVn-4 
dispiaysi arrtwhead on " 

screen I-9yVn-37 

irthitoit ar^row VII^22 
location in unit remembered 

VII-l.VII-37 ^ 
restarting at -arrow- fo^ each 

response VII-2»Vil-37 
satisfy all '-arrow-s befdre leaving 

main unit VII-2tVII-37 
search for additional 

-arrow-s VII-2.VII-4.VI 1-37 

rgoto- sk1ppedJ^II-42 
delimits precediftg 

-arrow- VII-4.VII-37 • 



V 



changes search state to regular 
state VII-4,VII-37 
sets default lonjL VII-8 
summary, of processing stages VII-37 
interactions with pther. 
commahdSx vn-44 
sets default long, jkey, 
copy Vll.4r : > 
rules for attaching units containing 
. -arrow- VII-5,VII-43 
merely collect response VI I -57 
sets left margin VIII-1 
with response erasing VIII-15 
-enablen for touch input XI -2 < 
assignment of^ values in a -calc- IV-3 
muljtiple assignments IV-4 
implicitly defined U-2 

in -store-Z-cbmpute- IX-^^8 

specs okassign IX-28 
assignment symboV IV-4,IX-?8 
•asterisk for comments J -12 
att^iched unit Ill-l ,V-6,VI-9 

by -do- III-l 

by -goto-. VI-:8 ■ ' * 

attempts (counting*studeat ^ ' < 
attempts) VI 1-20 
audio device^ XI-3'' ^ 
automated display generation II-9 
Automatic response-associated 
erasing VIII-16 
automatic scaling with 
graphing commands VIII-8 > 
auxiliary unit (see attached unit). 
Avner, Appendix A 
-at- 1-8,11-1 

default -^t- after response VII-2 
. one or two arguments II-l ,IV-9,IV-11 
sets left margin VIII-l 
where system variable VI I I -2 
wherex and j^herey system , ' ' 
variables VIII-3 

comparison with -origin- VIII-13 
-axes- VIII-9 ^ ■ 

(also see -bounds- VIII-10> 



-back- 1-11.1-12-^ 
-backl- V-10 , 
-backgnd- Appendix B \. 
BACK an^ BACKl return from - 
help sequence V-5 
backspace I-4,VIII-4 
-base- V-5 

base pointer and base unit V 
q or blank to clear V-5 
autoniatically cleared when 
unit reached V-5 
set base pointer V-5.V-6,VI 



I0(-12) 




base ^Mnlt I-12,V-5» V 
bialc TUTOR/ I -7 
binary notation IX-13JX-19 
bit manlpii^lation IX:^13 ^ 
SclsJ-tlrcular left shift IX-18. , 
IX-20 

$ars$ arithmetic right shift 1X720 
- and negative numbers IX-23 
$mask$ IX-20 , 

constructing masks in octal IX-21 
$unior^$ , IX-23 ^ 
$d1ff$ IX-.23. . 
y bitcnt function lX'-23 
\ packing data IX-20 ' 
: A octal nijimbers IX-21 - • 
\ complementing bits IX-22 ' . 

byte manipulation IX-24 
bitcnt furtctiort IX-23 , 
-bounds- VI 1 1 -to ' ' < 
-branch- IX-10 ' 
(atso see -goto- VI->, -doto- 

statement laibels'iX-lO 
^ iicalc or non-calc type IX-ll 

branch q IX-l Vo 
: must not have^ duplicate labels IX-ll 
e^,^. cannot bran^past -entry- IX-ll 
:«>^speed advafixage compared 

with -goton- I){-12 
blr^pfch^iig V-1 \ 
N *conditionffl VI-1 

i withirr a unit, see -^branch- ^IX-IO - 
broken or dashed circle -circl^b- II-2 
-bump^ VII-2I.VII-49 

combinations of^-put- ^ * - 
and -bump- VIt«rS2 

with shift characters VI'r-52 * 
affects -store-^nsv- IX-25 

bumpshift specs op^'on I-10,VII->1 

byte manipulation IX-24 V 
(also see bit manipulation) 



-calc- n-l.IX-1 

cqn^ional -calc- * ' 

(-calcc- and -calcs-) VI-7 
' X is not the fall -through 

. option VI-7 
summary IX-l^ 

statement label equivalent 
-cal'c- IX-10' 

with Integer variables IX-17 
-calcc- vr-7 (^ee -calc-) 
-calcs- VI-7 (see -calc-) 
calculations IV-1 

carriage return^^nd left m»g1ns VIII-1 
-catchup-* 1 1 -7 , ^ 

automatic X-10 ^ ^ 
central memory X-3 
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* -change- Appendix B 
character grid * 
coarse 1-8 
-fine II-l 
character set VI I 1-5 
character. strings VII-53 /- ! ' ' 
. see -bump-^and -put- for .student 
character stMngs , / 
see -f)ack- , -move-^ and vsearch- 
for othtfr string^ . ' ; 
single^qjttote marks (* dog*) . 
VII-54.IX-1^>' . ' 
double quote marks (^*dog") 
VII-58.IX-18 • ^ , 
6-bit character ctJdts I)(-16. 
and -qalc- IX-17 / . • ^' 
and '•computet- IX-2j5 • 
characters * . ' . 
c^laracter grid / 

(coarse 1-8, fine II-l)' 
character, si ze (8*1 B)--^ 1 1 -8 
TO per-yartable VII-9.IX-16 
special characters VIII-4 
•-char- VIII-22 

-charset- VIII-5;vin-6,Vi II-7',VIII-8/ 
-charts t- Appendix B ' . ' • C: 
charts (seejgy^aphing cbmmand's) 
Cheshire cat.III-2 ^ / 

- rdri 



■I 



i 

raw- 



Viri-12 



Chinese character;B with 
-fcircle- 1172 
-circleb- 11-2 
circular left shift $cls$' IX-18,I^;20 
-clock- command VII ' 
clock system vapiaSle Vn-'Se ^ 
-close- Appendi-x B 
coarse grid 1-8,11-1 . ,/ 
commana 1^7 * > r 

list of commajids Appendix 
comments (* 1-12, $$.II-3) . 
-comToad-^X-6,X-ll . i\ 
-common-^ X-1 ' > , / \ ' 

temporay^yl common X-1 . . \ 

uses of.-^ temporary confimon X-2 
-common-" not; executed • X^-2 
permahent coiition X-3 / • / ^ 

splitting aftiong mai^y students X-12. 
and the swapping process 'X-6 ' ^ 
locking ^common X-8 
common variables X-1 (also^see -common-) 
compile IX-25 

complementing bits rX-22 \ 
-compute/ IX-25 tseQ -iWa- IX-28). 
conditi6nal commands VI-l 
„ Gonditioft can be complicated 
• expression VI^2 * 
condition rounded to ^nearest 
' integer VI -2 * 
with logical expressions 'VI-S 

more precise duetto rounding VIt3 
consiilt specials terra XI-^ ' 
continued -wrtte- staterpent VIlI-1 



conversions ' ■ 
" . between octal and decimal I)j;-22 
'between alphanumeric fl^nd " ' 
numeric IX-25,IX-28 - 
, ,^C0ursev VII-56 - - 
^ *" ' . ^course registfatioT^ VIII-21 

i-concept^ Vn-15 (see -vocabs- Vir-15) 
with numbers VI 1-1 6 ' " * 
. \ ^ synonyms VII-16 ,^ ^ 
; N markup of- student response Vli-16 

\ \ ' \ iiiiss^ing word$ VII-1& 
\ ^lT^^sspelfings VII-16 
^ specs bkxvocab^VIJ-16 ^ ' . 
jriteraction with -answ^r-^r / * 
Swrong- y.I I-17 
' "with- judge wrong* VI I-*l 9 * 
synonomous" -conceptts yn-igi - - 
' ' • \, . ariscnt unchanged VII-19 

, with negation VII-24 a/ 
i - concept/vocabs-similap to \ 
^ ansv/define vri-27' 
^ -copy- JII^45, 1-5^ • 
» copy key disabled by -arrow- VII -45 
copy^cqmpired with edit Vn-45 
cursoV moving routine VII-Zlv. 
'witW -match-' VII-24 
withV-keytype- VII-58o- 
• cursor special -.term' XI-5 ^ 

Curtin, C. following 1-2 . 
- - Cyril lie. character's VIII-5 ' " v 



dashed or broken circle (-circleb-) II-2 
data from student .responses XI-3 . 
-data- V-iO: . 
-datal- V-IQ 
•'dat^^off- Appendix B 
-dflitacn- Xl-a 
data bases X-3,X-12' 
data files XI-3 , 
dataset operations X-1 2 
-date- VII-56 * \ - 
Davi-s, C. I-l \ ^ 

^aayr VII-56 \ 
debuggingv facilitated by -do- 1II-2 
decimal and octal conversions IX-22 ' ^ 
-define^ JV-4,IX-2.IX-27,IX-28 . ' ^ 
use?^ -define-, avoid primitives IV-5 
-define- must precede 
* related -calc- IV-4 
explicit multiplication- 
>equiTed;IV-5,IX-27,IX-28 
^ overr i (11 ng^ system variable 

definitions IV-lt,IX-27,l)(-28 - 
f student define *set VII-7.VII-26, , , 
. IX.25,IX-27,IX-28 

with algebraic judging VII-27 
with scientific units Vll.32 
with indexed variables IX-'B 
in grafit IX-27 
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I defining funpitions IX-2 
warning about 
• - ^ .defining v. n. vc/-or nc fX.4,IX-5\ 
' dejfining arrays IX-B", * 
defining segmented' variables IX-6 » 
^delay- Appendix B ' ^ 
-deltd- yiJI-10 
desk .caleulator VI I -6 
; dialog' 'V . 

• (wt^h -poncppt- and -vpcabs-^)-,VIN,M 
*'v dictionary using -term- y-12 - ^ ' 
v$<liff$ IX-23 ^ , ' 

Vtiimensibnaltty of scientific . ' . 

units in -storea- VII.31 / * . 
•-ilisable- XI-2 

' disk permarfent stcfrage Xr5,X-12 
-doir^II-I (also see -idolio-, IX-12) 
Htqrattve , . - 

compared \/ith ''■ ' . / 
coriditional. -goto- VI-12 ^ 
/ c^autton about slowhess of 
segmented' variables IX-lO 
^ con^itidnal VI-1 ' \- ' , 

cqncJitipnal iterative'-do- \/l-13 ' 
Special meaning of q ?|nd x \n-13 
■'"undo wtij6D -unit- comjiifand 
encountered 'VI-10 
do q like gHa q VI -ir 
like -join- ;'e)cc^t, regular 
_only yil-3,yii:3> / 
sicipped during judging and 
search VlfpS ' . 

do-ing -arrow-s VII-5 
text-insertion pa^iure .711-5 

-gotoy causes 
, eicception Vr-lO.VII-40 
judg.i^ng^ command . V 
prevents un-do-ing VIN37,VIl-40 
do level 's'aved at -arrow- VI 1-44 
nested -d6-s IX-S 
' -exit- from -do-s lX-29 
dollar'signs for comments IIt3 
-dot- VI 11-2 ^' ^ V 

rdoto- IX-T'2 • ^ 

.^ relation to branch q, l'x-13 '\ 
dots on scrfeen* II-l / ' 

-dot-" Vi I I -22 ' ' . 
display streen 1-2 - 
displays II^l* ■ ' ' \ 

automated display generation II-9' 
-draw- coarse grid 1-8, fine grid 1 1-2 

automated display generlation ll-g 

e)(ample with . ' / - 

^^complicated expressions IV-8 ^ 
from current position Vlll-S/Vlff-ll 
skip option VIII-10. , . 
updating of where, ^ 
wherex, wherey VIII-10 
' number of points VIII-Tl 
Jrispn with -gdraw- Vin-12 
prairi son with -rdraw- VIII-12 
-window- VlII-14 





compj 



erasing associated — ^ 
with, res06'nse VI 1 1^17 
makina dbts^ VI 1 1 -22' 
dmis ^/ / : ' ' 
arithiiietic Tl-26 
vocSbuk^y/VIIn35,VII-36.VIII-T9 



:#ait- VlI-45,J-4 V 

j edit Compared wit'h bopy VII-45 
em|beJdded^sh6W coninarids' in • 
|wr1te- statement IV-&^ 

s f pm -show-, a for -showat^ 
, t for -showt-T e for -Showe-, 
, and 2' for -sh6wz- lV-9 
I Sii -^rdtec- VI-6 * : 
-.^nable-^I-i2 - ' , . 

-6nd- I-12,y-4,V-5,VIII-21 \ 
ignored frv-nori-help sequence'^V-S 
erfd lesson^^-36.XI.4 * , 
^ndarrpw- I-13* Kl«,ViI-4vkl-5 ' 
v^xdelimits pr^edihg^ 

Narrow- I-f3,VII-5VVII-37 
changes searth state i ^ 

to r^ular-state VII-5,wi-43 
pause between >^arrow-s" VII-S. ' 
at pnd oXunit ViI-5 
Required iX^-ar^^ 
or joined' Hl-5. VI 1-43 
--entry- VI-12 (aW see -unit-f 

i use in votabulary drill VLri^2a 
-equality rounding 

in Ipgical expressions VI-4,IX-3. 
equations ih algebraic judging VII-3d 
. -erase- 11-4,11-8 ^ 

automatic full -jscreeh era'Se ' 
for new main unit 1-12,1-14, V-2 
Inhibit erase VII.46,VIIIXI9 
explicit' -erase- Vin.21 \ 
^ase .mode 1 1 -7 , ' ' - \ 

used in erasing reisponses VIII-16 
"-eraseu- VI 11-18 / 
erasing student responses "VI II -15 
-exac|f«jyfeV^-34 ' v 
handles fJunctUcltibn 
marks VII-12.VIi-34-^ 
_ • ignoring blank r^sponse^s VII-49 

compare with- blank -answer- VI 1-25 
-exactc- VII-35 (conditional -exact-) 

in a vocabulary drill VII-35 
exclusive union (sjee $diff$ lx-23) 
-exit- IX-29 

exponential show command, -showe- IV--9 
exponents in|/flo^iting-point 
numbers IX^fS 

expressions ||roathematical ) IV-T 
usable ^Wywhere IV-8 < 
logical Expressions VI-3 
^ mixin^llogical and 

numerical expressions VI-4 ' 
student Expressions VII-6,VII-7 " 
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^t- and 
-plot- VLII-22 



-exti XI-0 
external Input XN2 
exttrnail output XI^ 



false (In logical expressions) VI/3 
-find- IX-28 (also see -searcl)- yiI-54) 
-findall- IX-29f 
fine grld /II-l 
-finish- X-2,X-B 

flags us Ings sc^gmented var1eit)lei IX-9 
float 1 ng-po1ttt jnumbef s^X^I 5 , IX-23 
font I-6,VIII-5 /^^ , 

force fonivm-^ 
^ • unaffectedly -s 
-rotate- VIII-? 
, using -char-^and 
-fore?- VII-8 

foif'ce long VII-8 

force font Vlll-i 
-foregnd- Appendix ^ 
fornx)k system variable 
VU-7,VH-27,VII-33,IXk2e 
-frainfe- VIIII-10 

-funct- Vni-10 (also s'ee IX-26) 
function keys 1-4^ 
functions IV-5,IX-i .Appendix C 
pai^entheses around function 
a-guraen^ IV-5,VII-6 
diiiens1onT€ss arguments 
fifr -stToreife- VI 1-33 . 
de 'lning yoyr bwn functions IX-2 
precedence overitrTlt-ln 
functions TX-27.IXt28 \ 
Inr (Integer part) IX-3.IX-V 
. sin (sine);IV-l 
sqrt (squarb root) IV-8 
modulo IX-3 ' 
bitcii4 (bit count) IX-23 
pi otti/ng functions IX-2g 




Ghe$quiere» J. 1-1 
gdlraw- VII -9 

(aPso see <draw- and -rdraw-) 
ompariscn with -draw-^ VIII-12 
;ompar1scn with -rdraw- VIII-T3 
, to-M-7 

al^o see -[><anch- IX-10^ -doto- IX-1 
mild fomn <m-jump- V-I-7 
cut off a unit VI-8 
does not change main unit VI-8 
relation to -do- VI-8,vr-10 
exception to text-Insertion nature 
of -do-'VI.10.VII-40 
summary of basic properties VI-11 

goto q VI-n,VII-36 
with -entry- VI-12 * , 
corpipared with iterative -Uo- VI-12 
passing arguments with -goto- VI-13 



a rec^ular command VIN3»VII-41»VII-42 
skipped during judging and 
search VI 1-3 
. vmust not use in , . 

attached -arrow- unit VII-5 
grafit language IX-27 
-graph- VIII-9 v ^ 

graphics I 1-1 

automated display generation I I -9 
graphing commands VIII-8 / 

-origin-, -axes-» -sc&lex-, -scaley-, 
-labelx-, -labeiy-, -graiih-, -hbar-, 
-ybar-, -gdraw-, -Ideate-, -markx-, 
-marky-, -vector-, -Iscalex-, , 
-Iscaley*, -bounds-, -polar-, 
-funct-, -delta-, -frame- 
grid II-l ■ ' 
-group- VII-59 (see -keyb^pe- VIN58) 



halfcirc subroutine example IV-3 
-hbar- VIII-9 (also see -vbar- VIIM) 
-help- I-ll.I-12,V-^4 
Irater -help- overrides 
earlier -help- 1-13 
help sequence V-5 
help sequence is a' 
slow subroutine V-7 
return is to beginning of 
' base unit V-7 
converting between help and tioji-help 
sequences y-6 

use of -jkey- to give help VII-46 ' 
importance of enaUing 
HELP VII -4a. 
with. inhibit erase VIII-21 



iefJ (see initial entry unit) 
-iter^'or- Appendix 6 
-ignore- judgtpg command VI 1-23 
-imain- V-12 
inactive lesson X-4 

indenting -branchy IX-lli Tdoto-IX-13 
jriiaex for students to use 



V-14 



with -term- V-11 
with -imain- V-13 
setting and clearing -imain- 
with -store-/-ok- VII-8. 
. with --match- VIl-24 ; 
Uwith -ansv- Vli-25 ' ^ 
indexed variables IX-1 (also see arrays) 
/with -storeu- dilmensionality VII-32 
/ warning about j 

JK defining V, n, vc» or nc IX-4,IX^5 
I- indexed common variables X-2 

-inhibit 

inhibU arrow VII-22 / 
• inhibitNerase V1I-46,VIII-19 

interaktion with -restart- VIII-21 



initial entry unit (ieu) Vlll-e 
wUh compute pointers IX-27 . 
, relation -to -restart- VIII-21 
^initializations 
general questions 

of initialization V-7^V-8 
unit pointers-<;|earted 

when new/fnain unit entered V-11 
use of -imain- V-13 
zeroing variables lX-6 
zeroing compute pointers IX-26 

fn ieu IX-27 * 
-window- not inttiiili;^ed • X 

by main unit VIIII.14 
rsize- and -rotatel- not initialized 

by main unit VIl|-14 • 
with -restart- Vifl-21 

initializii^variables VIII-22 
zeroing temporaiSi(NCommon X-1 
zeroing -storage-A^2 

int function for integer part IX-3,IX-17 
integer variables IX-1 7 

common integer variables X-2 
Instructor mode XN4 
insertion of subroutine (by -do-) III-l 
interactions of -arrow-^ 

with other commands VII-44 
Introduction to TUTOR, 

Ghesquiere,' Davis, Thompson I-l , 
iterative -do- IV-G.V-B. 
-itoa- IX-26 J 



jcount system variable 

affected by specs bun#hif^^II^12 
and 4bump- VI I -50 
and -but- VII-51,VII-52 
-jkey- VII-45.VII-46 

default Set by -arrow- VII-45 
with response erasing VIII-15 
-join- VII-3 (ilso see -do-) 
universal ly executed (regular, 
judgind, search) VII-3, VJN38 
like -do- except universal 
VII-3/VII-37,VII-40,VII-49 
join-rng -arlroW-s'VII-5 
text-insertion nature VII-5,VII-40 
-goto- causes exception 
VI-10,VII-40 
dudging command 
prevents* un-do^ing VII-37,VII-40' 
repeated executiolLin regular. 
Judging,, search sl|d;es VIU^B 
-judge- VII-18,VII-19^^ 

-judge- is a regular i%mand VI I-l 8 
judge wrong used to stay at -arrow- 
VII-18,VIII-19 ' 
does not stop processing VII'i*21 
in student data XI-3 
judge ok VII-19 

does not ^stop processing VII-21 
judge continue VII-20,VII-47 
in algebraic Judging VII-28 
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-storen-. 
-ignore-) 



i 



VII-2 




VIM f 

I- 2,VII.3 I 

II- 3,VII.37^ 



Judge rejudge VII-21 ,VII-SO 

affects -store-/-ansv- IX-26 
Judge ignore VII-21 

stops processing VII-21 
ignoring blank responses VII-49 
Judge exit VIl-22 
jadge no Vll-23 

in student data XI-3 
conditional form of -judge- VII- 
Judaing commands VII-1 

(see -arrow-, -answer-, -wrong- 
-concep^-, -match-, -ansv-, 
-wrbngv-, -ansu-, -wrongu- 
i -store-, '-storea-, 
•exact-, -exactc-, 
j simmary VI I -61 
fop processing tn 
regular state VII-1 ,VIi-39 
ly terminate Judging state 
[k arid no Judgements VI 1-2 

d^faultTio VJI.2 , 
require an) -afrow- comniind VINl 
skipi^ed in search state VII« 
^ delimit regular/ conmands VII- 
accessed by -Jdin- VII-3 
switching frolh regular to% 
Judging state VII-20 
Judging copy of student response VII-21 

affected by -bump-,VII-50 
Judging keys VII-45 (iee -jkey-) 
Judging student responses VII-1 
-jump- V-9 

initlalizktions V-9 

base pbinter not affected V-9 
cancels previous -do-s V-9 
screen erased V-9 
used with -base-to initiate 
help sequence V-9 
compared with -goto- VI -7 
-Jumpout- XI-4 ' 



key system variable VII-46 
key names VII-46, yiI-58 
catching every key VII-57 
key codes VI 1-58 
timeup VII-59 

with touch and external input XI-2 
keys^ or keyboard 1-3 
-keytype- VII-58 (see -group- VII-59) 
keyword Judging VII-23 
-kstop- Appendix B 



-lab- V-10 
-labl- V-^10 

labeling Ijraphs VIII-8 
labels on statements - ' 

for -branch- IX-TO, for -ddto- IX-1 2 

must not have duplicate labels IX-11 
-labelx- Vlll-g (see -mar kx- VIII-9) 
-Tabely- VIII-9 (see -marky- VIII-9) 
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large-sizfi writing I I -3 ' 
left shift 

(see circular left shift IX 
lesson space VIII-7.X-3 
lessons not swapped X-6 
levels of -do- (10 permitted) III-2 
. line drawings (see -draw-) 
line-drawn characters 
(see -size- and -rotate-) 
-list- VII-13 

in -answer- and -wrong- VII-13tVII-14 
-loada- VII-53.VII-54 
-locate- VIII-9 (also see -at-) 
locking common X-8 
logical expressions VI-3 

in conditional conroands VI-3 
mixed with numerical expressions VI-4 
logical operators =,^,<,>,i^,^ VI-4 
roun^loff on equality VI-4.IX-3 
logical ot)erators $and$, $or$t (not) 
VI-4.VI-S 
-long- VI 1-8 

force long Vri-8.VII-44 , 
follows -arrow- » precedes- judging • 
commands VI 1-8 
modifies -arrow- VII-8 \ 
must precede -specs- Vlt-lt 
long 1 with judge ignore vil-22 
default set by -arrow"- VI 11-44 
-edit- for long greater 
than ^50 VI I -45 
-Iscalex- VIII-10 (see -scal0x- VIII-9)* 
-Iscaley- VIII-10 (see -scaley- VIII-9) 



main unit V-l,V-6tVI-9 

not affected by -g()to- VI -8 - ^ 
margin set by -at- anp -arrow- VIII-1 
marker 

-arrow- marker yiIli-1 ,VII-2 

-specs- marker VII-12,VII-13 i 
markup of response VI I -2/ 
-markx- VIII-9 (see -labelx- VI 
-marky- VIII-9 (see -labely- VI 
masking in bit manipulations 
($mask$) IX-21 
-match- VI 1-23 

also see -storen- VIN25 

in grafit lang4jage IX-27 
mathematical expressions IV-1 
merge (see $union$ IX-23) 
-micro- VIII-8 
microfiche XI-1 
micro-key options 1-5 
micro table VIII-8 
-mode- (erase, write, rewrite) 
II-7,VIII-4,VIIIr7 

conditional form VI-7 
-modperm- VlI-36 (alsc see permutatfons) 
modulo function IX-3 



II-9) 
II-9) 



/ 



V 



-move- VI 1-53 

multiple -arrow-s I-13.VII-4 ^ 
multiplication 

explicit between defined names IV-5 
(except for, students VII-7) 

takes precedence over division IV-2 
music XI-3 



-name- VII-56 

naming variables (-define-) IV-4 
negative words VI 1-24 
-next- I-11,V-1 

put near beginning of unit V-2 

successive -next- commands 
override V-2 

"next " or "next q" to clear 
pointer V-3 
NEXT key J-4,V-2 

always a judging key VI I -45 ^ 

ignoring extra NEXT keys VII-49 
ne;<t physical unit V-2 \ 
-nfxtl- V-10 
-nixtnow- 1-11,1-13 
-n6- VII-8,VII-23 

in arithmetic drill VII-26 ^ 
noidtff specs option VII-11 
ftpn-help sequence V-5 

converting between help and nqn-helt^ 
sequences V-§ ' 1 
non-numerical parameters specified 
by student VII-8 i 
nookno specs option VII-12,VIII-19 ' 
noops specs option VII-26 
noorder specs option I-10,VII-12,VII-19 
not (logical function) Vr-5 
notoler specs option VII-11 
novars specs option VII-26 
-noword- VI 11-20 
numeric information different 
'from alphanumeric Vir-^.VII-lO- ^ 
r range of numerical values IX-13 
numerical parameters specified \ i 
by student VII-6,VII-25 

checking for negative VI 1-20 X 
numerical and algebraic judging vYr^5 

algebraic VI 1-27 



octal numbers for masks IX-21 

octal show command, -showo- IV-9,IX-22 

-ok- VII-6,VII-20,VII-23 

okassign specs option IX-28 

okextra specs option I-IX), VII-11 

okspell specs option VII-11, WI-19 

-okword* VIIN20 

okxvocab soecs option VII-16 

opcnt system variable VII-26, VII-28 




•ope»« Appendix B 
'Operations (see precedence) 
optional words 

In -answer-Z-wrong- 1-9 

In -vocabs- VII-15 
-or-, judaing oonmand XI-2 . 
or {$or$) logical operator VI-4 
-origin- VIII-9 

comparison with -at- VIII-13 
-OutpiJt- XI -4 
-outputl-. XI-4 

-pack- VII-53.V«^5S 
parentheses around function 
arguments IV-S.VII*6 ' 
partial circle II-2 
passing acguments IV-9 (see arguments) 
-pause- II-4,1fII-57 ' 
between -arrow-s. 
with -endarrow- VI I -5 
catching every key VII-S? 
no key display VII-60(- 
no help at Blank -paus^t- VII-60 . 
pause keys-atb.etc. VIP60 " 

help, term, etc. possfMe VII-60 
NEXT key special VII-60 
-return- )^-10 ^ 
permanent common X-3 (also see -common-) 
permanent storage area X-4 
permutations VIl-35 
-randp- VII-35 
-setperm- VII-35 
-remove- VII-35 
-modperm- VII-36 
vocabulary drill VII-36 
photographic projection XI-1 
physical jiext unit V-2 
place notation IX-19 
T^lasma display panel 1-2 
-p%- XI -3 
-plot- VIII-22 
plotting functions IX-26 
(also s^e -funct- VIII-10) 
pointers (flibxt, help. base, etc.) 
q Of Mank to clear pointer V-^.V-7 
success Iv^onmands override 
earlier settings V-3.V-6 
^c lea red when Jiew 
main unit eiite)(;ed V-11 
compute pointer lX-26 
, zeroing in leu 1^-27 
pointing at toiich panel /l-l 
-polar- VlII-l<) 
positioning II^l 
powers in floating-pbint numbers IX-lX 
pre/edence (of maiffematical operations), 
lV-l,VII-31,IX^7.IX-28 
eparing lesson for active use X-2 
-press- Appendix B 




primitive vHriablt' names 
(vl-vl50) IV.2.IV-5.lX-27.IX-2af 
-put- VII.21,VII-51 
affects jcount VIN51 
terminates Judging if string 
too long VII-51 
combinattons of 
-put- and -Bump- VI 1-52 
affect? -store-/-ansv- IX-25 
-putd- VH-M (also see -put-) 
-putv- VII-52 (also see -put-) 



q (^special unit name) Vi-3,VI-3 
clears unit pointers V-10,VI-3 
goto q VI-11, VII-36 ' 
in conditional iterative -do- VL-13 
wrfth -branch- IX-ll 

quote marks for character strings 
single ('dog') VII-M, IX-19 
double ("c|og"j^ VII-58,IX-18 

* 

random numbers 

(see -randu- and permutations) 
-randp- VII-35 <also sea permutations) 
-randu- VI -5 

arithmetic drill Vir-26 

algebraic Judging VII*27,VII.28 

compared with -randp- VII-35 ' 
range of numerical values IX-13 
-rdraw- VIIl-12 

affected by -size- and 

-rotate- VIII-13 

compared with -gdraw- VIII-13 
readability with subroutines III-2* 
-reada- XI-4 
-readl- XI-4 
-readset- Appendix B ' 
-record- (Appendix B 
registration r*fecords VIII-21.X-4 

-storage- riot saved X-11 
regular commands VII-1 

skived in Judaing 

state VII-1 ,vn-20.VII-37.VII-39 
skipped in search 
state VII-2,VIN3.VII-37 
-do- and -goto- Sre regular , 
commands VI 1-3 
switching from regular to 
Judging ^tate VII-20 
^ judging command stops and 

prevents un-do-^ng VII-37,VII-39 
-remove- VII-35 (also see permutattons) 
responses (see Judging) 
response data XI-3 
-restart- VIII-21 

(also tee initial entry unit VIII-6) 
-storage- not saved X-11 



rtstartlniM^HI^M^n VIII-6 
(*rtstirt- comnind VUI-21)* 
*rttum« X*10 (also stt -paust*) 
rttucn from htlp sirqutnce V-S»V-7tV-8 * 
rtwrltt nodt II*8,VIII-4,VIII*7 
right shift 

(stt trlthmtlc right shift |X-20,IX-23) 
*rotatt<» 1 1 -3 
,1nttr«ct1on with *arrow- Vn*44 
afftcts -writtc- VI-6 
x^ots not afftct altarnatt.font Vltl'^ 
afftcts -rdraw- tven- 
In sizt 0 VIIN13 

not Initial Iztd by main unit VIII-14 
rounding ^ 
^ of condition In conditional 
commands VI -2 

In equality operation VI -4 

In Indtxed varlablts IX-4 

In segmtnttd variables IX -7 

wtth Integers variables IX-17 
-route- AppendlxXB 
routers XI -4 y ^ ^ ^ 

•routvar- Appendix B * 
Russian alphabet Vtll-S 



-scaleW-scalby- VIII-9 
(also see *uca1ex-/-1sca1ey- VIII-10) 

comparison with rsize- VIII-13 
scaling In graphing commands VIII-8 
scientific un1$^ VII-31 (see -ansu-) 

-search- {Character string 
coimtirnd) VII-53,VII-54 
search state (looking for additional 
-arrow-s) VII-2,VII-37, 
skips regular and 
Judging commands VII-2 
segmented variables IX-6,IX-24 
table of ranges and space IX-8 
signed Segments IX-7 
fractional numbers IX-9 
slowness IX-10 

equivalent bit manipulations IJ(-^0 

byte manipulations IX-24 
selective erase 
(text n-4, araphlcs II-7) 
sequentsing V-1 * 

summary of sequencing commands V-10 

author-controlled and 
student-controlled V-11 

within a unit, see -Branch- IX-JO ^ 
-setpatrm- (also see permutations) 

Sherwood, B. following I-2.IX-27 
Shtrwoodi J. following 1-2 
shift character 
\MI-9.VII-50.VII-S2.VlI-S5 
shift operators 

($cts$ IX-18JX-20) ($ar^ IX-20) 




skip In -draw- Vl|l-10 
-show- IV-8 

significant fld^res IVr8 
-shjowa- (a1phan|)meric) IV-9,VII-9^ 
' default length V|Ir9 
uses 6-b1t ctbra^ter codes (X-ie 
Ignores null Characters IX-17 
with V or n,\fr1ab1es IX-18 
-showe- (exponenllal) IV-9 
-showt- i tabular jLjV-9 
-showo- ^octal) w-9.1il*22- 
-showz- (show trailing zeroes) IV-9 
automatic era$1nQplIN16- « 
$1gn-1n/s1gn-out vni-21,X-4 
simulation. of Judging and search VlI-3 
sin (sine function) q^-V 
-size- 1 1-3 :h * 

1nterat;t1on with -arrow- VII-44-"^ 
affects -wri tec- Vff6 ' 
. does not affect aYt|mfte font VIII-7 
affects -rdraw- Jfttfrl3 
comparison wlWf -Jcilex- VI 1 1-13 
not Initialled by mkln uhlt VIII-14 
sklpplog overymaln units V-1 
-slide- XI-F 
Smith, S,,/ ^ \ 
followlJrg Iw2,VlI-14 ■ 
smooth animations VIII>7 
special Characters VIII-4 
specifying parameters 
numerical 

-store- VII-S 
with -£hpw- VIl-'lO 
non-numerical ^ 
-storca- VII-8,VH*9 
with -showa- Vll-tO 
-scecs- I-10,VH-11 

notoler, nodiff VII-11 
bumpshlft I-10,VIM1 
okspell VII-11 

with -concept- *H^19 
okextra I-IO7VII-II 
noor^er J-10,VII-12 

with -concept- Vn-19 
nookno VII-12,VIII-19 
okxvocab VII-16 
noops^novars VI 1-26 
okasaign IX-28 
-specs- Is a Judging command VII-11 
-specs>- sets a y , 

marker VII-12»VII-13^Vll-37 

later -specs- overrides 
o earlier marker Vll-r 
^ clears anscnt VII-17 

speech XI -3 . 
$pe11 system variable Vh-13 
square root function, V 
sqrt(expresslon) IV-8 
statement has command and tag 1-7 




stittMnt libtl 

with -branch- IX-IO, with -doto- IX- 
Must not hivt dupljcatf libtis IX- 
stitlon s^stM vtrliblt X«9 
status bank X-3« ^ ^ 
-sttp* conaand XI-5 
sttp sptclal ttm XI-5 
-stoload- X-n 

*?storaga^ X-ll (also stt -comroon-) 
not savtdT on sign-out x-ll 
ztroad on S1gn-ln X-12 ^ 
•stora- VI I -6 • 
a Judging conn^nd VII-6 ^ 
Judgas no If cannot evaluata VII-7 
with -show- VII-10 
compared with -storen- VI I -25 
"with -aniv- VII-25 
concapt/vocabs similar to 
ansv/daflna VII-27 
warning about (1/2k) VIN31 
affactad by -bump-, 
-put-, and Judga rejudge IX-25 
no primltlva varlabVa 
names IX-27,IX-28 
no assignments without 
specs okassign IX-28 
store values Into variables IV-2 
-storeii- Vn-8»VII-9 
with -showa- VINIO 

ith character string 
/manipulations VII-S3 
/4ipposite of -loada-/VII-53 - 
/compare with -packy VI 1-55 - 
\merely collect response VI I -57 
\67blt character codes IX-16 
V or n variables lX-18 
-storen- VII-25 

also see -match- VII-^3 
and ^tore- VII-6 / 
-storeu-^II-ai" / 

termlna.tiiji/ judging/if error VII-33 
warning atout (3t6cm) ^ 
with -stdreu- V1N33 
Strings VI1//53 (sj?t character strings) 
student defAne set VII-7 
(also see -defljrte-) 
student /esponsj^s VII-1 
storing responses 
(Me specifying parameters) 
eiglng responses 
see Judging commands) 
student /response data JU^ — 
student specif tcatton of parameters 
/see specifying parameters) 
Itudent variables (vl-vl50) IV-2 
in displays IV-3 

compared with cornmon variables X-1 
augment with -storage- X-11 
-subl- Appendix 8 ^ 
superimposing writing II-8,VIII-4 
superscripts and subscripts I-5.VIII-3 
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' system variable IV-11 
anscnt VIl-17 
args IV-11 
ClocNCvn-56 

formok VII-7,VII-27,VII-33,IX-26 
Jcount VII-9 

affected by specs buntpshift VII-12 
• and -bum))- VII-50 

and -put- VI 1-51, VI 1-52 
key VH-46 
opcnt VII.26,VII-28 
spell VI 1-13 
station X-9 
varcnt VII-27,VII-30 
vocab VII-18 . * 

where VI 11-2 * 

updating in -draw- VIII-10 
wherex VIII-3 
wherey vni-3 
subroutines III-l ^ 
superscripts arid subscripts Vin-3 
swapping process X-3,X-6 
swapping memory X-4 
and conmon variables X-6 
synonyms 

in -answer- I-9,VII-13 
(al^o see -list-) 
in -Mncept- VII-16 
(alsro see -vocabs-) \ 



table of square rodts IV-8 
-tabset- Appendix 8 
J:abular show command, -showt- IV-9 
tag 1-7 

talk special tehn XI-5 
temporary common X-1 
(^iiso see -common- j ^ 
Tenciar, P. following 1-2 
-term- V-11 

complementary to -help- V-11 
dictionary use V-12 
duplicate terms an error V-11 
• synonyms V-12 

step, cursor, consult, talk XI-5 
terminal capabilities I-2,I-3,XM 
text (see -write-, -size-, -rotate-) 
text Insertion of subroutine • 
_(by^o-^ III-l 

-arrow- in subroutine VII-5 
Thompson, C. I-l 
tick marks on graphs/VIII-8 
-time- 11-6 
time-slice X-8 
timeup key VII-59 
tolerance 

with -answer-/-wrong- VII-11 
with -ansv-/-wrongv- VI 1-26 
with -ansu-/-wrongu- VI I -34 
on equality operations VI-4,IX-3 
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-touch- Xl^ 

(ouch panel XI -1 

-transfr- IX-6 

not vdth segmented variables IX-7 
with -conwon- or -storage- X-n • 

tries (counting student attempts) VI 1-20 
^ true (in togical expressions) VI-3 

i ■ " r 

r 

^unconditional^ commands^ VI-2 
''•'(also see conditional commands) 
$un1on$ IX-23 
(also s^ee $dtff$ exclusive union IX-23) 
-unit- 1-8 

terlminates preteding ,unit VI-10 
see -entry- vl-12 
(which does not terminate) 
must not hsive / 
.duplicate -unit- names IX^-11 
unit\pointers (see pointers) V-2 . 
unUsMscientific units) VII-Sl- 
universiH 

ex^cu^on.of -join- VII-3 
-use- AppeYidix B . 



varcnt system variable VlI-27,VII-30 
variables " " / 
student variables I V-2 
with -restart- VIII-22 
with -storage- X-11 
indexed variables IX-3 ^ 
with -storeu- 
dim^h^pnality VII-32 
common- variables X-1 
segmeiitedfvariables IX-6 
range of numeric valufe IX- _ 
-vbar- VIII-9 (also see -Rbar- VIII-9) 

ictor- VIII-10 
voc^ system v^ariable VII- 
-vocabXyiI-19^. 
-vocabs- vlI-15;XI-3 
(see -concel>tr VII-15) 
vocabulary drirN(lI-35,VII-36 





where system variable Vlll-a 
updating in -draw- VlH-10 
wherex system variable Vlft^^ 
wherey system variable VIII-3\ 
-window- VIII-14 * . 

-write- coarse grid 1-8, fine grid II-2 
with embeddid show commands. IV-9 
s for -show-, a for -showa-, 
t for -showt-^, e for -showe-, 
and z for -showz- IV-9" 
conditional -write- (-writec-) VI-5 
wHh left margins VIII-1 
continued -write- statement VIII-1 
successive -write- ^statements VIII-2 
also see -size- and -rotate- 
size 1 versus size 0 VIII-13 
automatic erasing VIII-16 
alterrrate font 
-with charset VI I I -5 
using -char- and -plot- VIII-22- 
write mode I 1-7 

-writec- VI-5 (also see -write-) 

X is nat the fall-through option VI-6 
special character 
. when using commas VI-6 
with embedded show commands VI-6' 
affected by -size- and -rotate- VI-6 
automatic erasing VIII-16 
-wrong- 1-9 (also^see -answer-) 
-wrongu- VII-31 ,VlI-33 (also see -ansu-) 
-wrongv- VII-25 (also see -ansv-) 
with scientific units VIl-33 



X (special j^mt name) V-3,VI-3 

-zero-/fx-6 

np€ with segmented variables IX-7 



ERIC 



Y 

225 



